List sales lines (sales transactions / sell-through)

curl --request GET \
  --url https://app.solya.app/api/sales-lines \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.solya.app/api/sales-lines', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.solya.app/api/sales-lines",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.solya.app/api/sales-lines"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.solya.app/api/sales-lines")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "brandCode": "maje",
      "brandId": "demo-brand-a57dc5b8",
      "brandImageUrl": "https://solyastagingwedataplatfs.blob.core.windows.net/brand-images/brands/maje/logo.png",
      "brandIsActive": true,
      "brandMainBrandTypeTaxonomyFullPath": null,
      "brandMainBrandTypeTaxonomyId": null,
      "brandName": "Maje",
      "code": null,
      "cost": 82.43,
      "costPurchasePrice": 82.43,
      "costPurchasePriceExclTax": 68.69,
      "costWeightedAverage": 82.43,
      "createdAt": "2026-06-13T03:40:41.912898+00:00",
      "discountArticleAmountExclTax": 0,
      "discountArticleAmountInclTax": 0,
      "discountGlobalAmountExclTax": 0,
      "discountTotalAmountExclTax": 0,
      "discountTotalAmountInclTax": 0,
      "inventoryItemCode": "INV-000096",
      "inventoryItemFullName": "Robe bohème à fleurs - Beige - XS",
      "inventoryItemId": "demo-inv-item-65e30fb4",
      "inventoryItemSku": "SKU-000096",
      "lineType": "sale",
      "margin": 201.5,
      "organizationId": "demo",
      "price": 183.18,
      "productCode": "robe-boheme-a-fleurs",
      "productFamilyMainTaxonomyFullPath": "Vêtements/Robes/Robes/Robes trapèze",
      "productFamilyMainTaxonomyId": "solya_family_fr_1ed879c0",
      "productGenderTaxonomyFullPath": "Femme",
      "productGenderTaxonomyId": "solya_gender_fr_43c65bcc",
      "productId": "demo-product-e95a1ecd",
      "productImageUrl": "https://solyastagingwedataplatfs.blob.core.windows.net/product-images/products/maje/robe_boheme_a_fleurs/image_0.jpeg",
      "productIsActive": true,
      "productName": "Robe bohème à fleurs",
      "quantity": 2,
      "saleCode": "S-00019188",
      "saleDate": "2026-05-08",
      "saleDateKey": 20260508,
      "saleDayName": "friday",
      "saleDayOfMonth": 8,
      "saleDayOfWeek": 5,
      "saleDayOfYear": 128,
      "saleHolidayName": "victory_day_2026",
      "saleId": "280f71de-9910-4064-8c37-3880a21d928f",
      "saleIsHoliday": true,
      "saleIsWeekend": false,
      "saleLineId": "00001750-0ce3-4486-917d-0466cbfbf52b",
      "saleMonthName": "may",
      "saleMonthOfYear": 5,
      "saleQuarter": 2,
      "saleSeason": "spring_summer",
      "saleTrimester": 2,
      "saleWeekOfMonth": 2,
      "saleWeekOfYear": 19,
      "saleYear": 2026,
      "shopCity": "Marseille",
      "shopCode": "boutique-marseille-vieux-port",
      "shopCountry": "66b26b04-1ae1-4c22-8b67-2175b9859797",
      "shopCountryId": "66b26b04-1ae1-4c22-8b67-2175b9859797",
      "shopId": "demo-shop-06490461",
      "shopIsActive": true,
      "shopName": "Boutique Marseille - Vieux Port",
      "shopRegion": "Provence-Alpes-Côte d'Azur",
      "sizeTaxonomyFullPath": "XS",
      "sizeTaxonomyId": "solya_size_fr_6e9ce024",
      "sizeTaxonomyLanguage": "fr",
      "tax": 36.64,
      "updatedAt": "2026-06-13T03:40:41.912898+00:00",
      "variantCode": "robe-boheme-a-fleurs-beige",
      "variantCollectionId": null,
      "variantCollectionName": null,
      "variantColorTaxonomyFullPath": "Couleurs Neutres/Neutre/Beige/Phantom",
      "variantDisplayName": "Beige",
      "variantFullName": "Robe bohème à fleurs - Beige",
      "variantGenderTaxonomyFullPath": null,
      "variantId": "demo-variant-dbb3f455",
      "variantIsActive": true,
      "variantName": "Robe bohème à fleurs - Beige",
      "variantSecondaryColorTaxonomyFullPath": null
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "total": 214803
  }
}

Sales Lines

List sales lines (sales transactions / sell-through)

Returns a paginated list of individual sales lines — the line-item sales transactions (what sold), each carrying quantity sold, unit price, revenue, discounts, cost (COGS) and margin, plus the shop, brand, product, variant and size it belongs to. Use this to analyse sales history and sell-through, compute revenue or units sold, or drill into discounting and margin, filtered by shop, brand, product, variant, line type, and date range. This is the granular fact table; for per-product roll-ups (best-sellers, totals) use GET /products, and for forward demand use GET /forecasts.

GET

api

sales-lines

curl --request GET \
  --url https://app.solya.app/api/sales-lines \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.solya.app/api/sales-lines', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.solya.app/api/sales-lines",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.solya.app/api/sales-lines"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.solya.app/api/sales-lines")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "brandCode": "maje",
      "brandId": "demo-brand-a57dc5b8",
      "brandImageUrl": "https://solyastagingwedataplatfs.blob.core.windows.net/brand-images/brands/maje/logo.png",
      "brandIsActive": true,
      "brandMainBrandTypeTaxonomyFullPath": null,
      "brandMainBrandTypeTaxonomyId": null,
      "brandName": "Maje",
      "code": null,
      "cost": 82.43,
      "costPurchasePrice": 82.43,
      "costPurchasePriceExclTax": 68.69,
      "costWeightedAverage": 82.43,
      "createdAt": "2026-06-13T03:40:41.912898+00:00",
      "discountArticleAmountExclTax": 0,
      "discountArticleAmountInclTax": 0,
      "discountGlobalAmountExclTax": 0,
      "discountTotalAmountExclTax": 0,
      "discountTotalAmountInclTax": 0,
      "inventoryItemCode": "INV-000096",
      "inventoryItemFullName": "Robe bohème à fleurs - Beige - XS",
      "inventoryItemId": "demo-inv-item-65e30fb4",
      "inventoryItemSku": "SKU-000096",
      "lineType": "sale",
      "margin": 201.5,
      "organizationId": "demo",
      "price": 183.18,
      "productCode": "robe-boheme-a-fleurs",
      "productFamilyMainTaxonomyFullPath": "Vêtements/Robes/Robes/Robes trapèze",
      "productFamilyMainTaxonomyId": "solya_family_fr_1ed879c0",
      "productGenderTaxonomyFullPath": "Femme",
      "productGenderTaxonomyId": "solya_gender_fr_43c65bcc",
      "productId": "demo-product-e95a1ecd",
      "productImageUrl": "https://solyastagingwedataplatfs.blob.core.windows.net/product-images/products/maje/robe_boheme_a_fleurs/image_0.jpeg",
      "productIsActive": true,
      "productName": "Robe bohème à fleurs",
      "quantity": 2,
      "saleCode": "S-00019188",
      "saleDate": "2026-05-08",
      "saleDateKey": 20260508,
      "saleDayName": "friday",
      "saleDayOfMonth": 8,
      "saleDayOfWeek": 5,
      "saleDayOfYear": 128,
      "saleHolidayName": "victory_day_2026",
      "saleId": "280f71de-9910-4064-8c37-3880a21d928f",
      "saleIsHoliday": true,
      "saleIsWeekend": false,
      "saleLineId": "00001750-0ce3-4486-917d-0466cbfbf52b",
      "saleMonthName": "may",
      "saleMonthOfYear": 5,
      "saleQuarter": 2,
      "saleSeason": "spring_summer",
      "saleTrimester": 2,
      "saleWeekOfMonth": 2,
      "saleWeekOfYear": 19,
      "saleYear": 2026,
      "shopCity": "Marseille",
      "shopCode": "boutique-marseille-vieux-port",
      "shopCountry": "66b26b04-1ae1-4c22-8b67-2175b9859797",
      "shopCountryId": "66b26b04-1ae1-4c22-8b67-2175b9859797",
      "shopId": "demo-shop-06490461",
      "shopIsActive": true,
      "shopName": "Boutique Marseille - Vieux Port",
      "shopRegion": "Provence-Alpes-Côte d'Azur",
      "sizeTaxonomyFullPath": "XS",
      "sizeTaxonomyId": "solya_size_fr_6e9ce024",
      "sizeTaxonomyLanguage": "fr",
      "tax": 36.64,
      "updatedAt": "2026-06-13T03:40:41.912898+00:00",
      "variantCode": "robe-boheme-a-fleurs-beige",
      "variantCollectionId": null,
      "variantCollectionName": null,
      "variantColorTaxonomyFullPath": "Couleurs Neutres/Neutre/Beige/Phantom",
      "variantDisplayName": "Beige",
      "variantFullName": "Robe bohème à fleurs - Beige",
      "variantGenderTaxonomyFullPath": null,
      "variantId": "demo-variant-dbb3f455",
      "variantIsActive": true,
      "variantName": "Robe bohème à fleurs - Beige",
      "variantSecondaryColorTaxonomyFullPath": null
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "total": 214803
  }
}

Authorizations

Authorization

string

header

required

User session token issued by NextAuth. For human users accessing Solya via the web application.

Query Parameters

page

integer

default:1

Page number, 1-indexed (default: 1)

Required range: 1 <= x <= 9007199254740991

pageSize

integer

default:20

Number of items per page, max 100 (default: 20)

Required range: 1 <= x <= 100

shopId

string

Filter by shop UUID

brandId

string

Filter by brand UUID

productId

string

Filter by product UUID

variantId

string

Filter by variant UUID

lineType

enum<string>

Filter by line type. Enum (lowercase, matching stored values): 'sale' (regular sale), 'return' (returned item)

Available options:

sale,

return

dateFrom

string

Return lines where saleDate >= this value (inclusive). ISO 8601 date 'YYYY-MM-DD' (e.g. '2026-01-01') or datetime 'YYYY-MM-DDTHH:mm:ssZ' — both accepted. Filters on the saleDate column.

dateTo

string

Return lines where saleDate <= this value (inclusive). ISO 8601 date 'YYYY-MM-DD' (e.g. '2026-12-31') or datetime 'YYYY-MM-DDTHH:mm:ssZ' — both accepted. Filters on the saleDate column.

sortBy

string

Column to sort by. Allowed: 'saleDate', 'quantity', 'price'. Defaults to 'saleDate'.

sortOrder

enum<string>

Sort direction: 'asc' or 'desc'. Default order is saleDate descending (most recent first).

Available options:

asc,

desc

Response

Successful response

data

object[]

required

Page of items

Show child attributes

System

Catalog

Inventory & analytics

Plans

Tasks

Intelligence

Search

Data export

Other

List sales lines (sales transactions / sell-through)

Authorizations

Query Parameters

Response