Skip to content
BILLZ for developers

Sellers

GET
/v1/seller-general-table
curl --request GET \
  --url 'https://api-admin.billz.ai/v1/seller-general-table?start_date=2026-08-01&end_date=2026-08-31&shop_ids=fbfb9d6c-cbb2-43ab-8c90-e97d2eeb34d6%2C92302dfb-fa33-4e6a-8d19-87214852b25d&page=1&limit=10&detalization=day&price_type=0&hide_sellers_without_sales=false&group_without_shops=false&currency=UZS' \
  --header 'Authorization: Bearer <token>' \
  --header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01'

Error codes: 400 — input validation error; 404 — object not found; 401, 403, 429, 500 — shared by all methods. Body formats and semantics: Response codes and errors.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
start_date
string format: date
Example
2026-08-01

Format YYYY-MM-DD, without time

end_date
string format: date
Example
2026-08-31

Format YYYY-MM-DD, without time

shop_ids
Array<string>
Example
[
  "fbfb9d6c-cbb2-43ab-8c90-e97d2eeb34d6",
  "92302dfb-fa33-4e6a-8d19-87214852b25d"
]
page
integer format: int32
default: 1
Example
1
limit
integer format: int32
default: 10
Example
10
detalization
required
string
Allowed values: day week month year

Day|week|month|year

Example
day
price_type
integer format: int32
0
hide_sellers_without_sales
boolean

An unrecognized value is treated as false

group_without_shops
boolean
currency
string
Example
UZS

Header Parameters

Section titled “Header Parameters”
platform-id
string
default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Platform identifier. A static value is used for integrations.

Responses

Section titled “Responses”

200

Section titled “200”

Successful response

Media typeapplication/json
object
seller_stats_by_date
Array<object>
object
date
string
seller_id
string
seller_name
string
shop_id
string
shop_name
string
gross_sales
number
discount_sum
integer
discount_percent
integer
net_gross_sales
number
net_gross_profit
number
sum_returned
number
sold_measurement_value
number
returned_measurement_value
number
sold_without_return
number
transaction_count
integer
orders_count
integer
average_cheque
number
average_measurement_value
number
average_price
number
net_sold_supply_sum
number
rounding_amount
number
free_price
boolean
used_wholesale_price
boolean
target
integer
sellers_stats_total

Total row

object
gross_sales
number
discount_sum
integer
discount_percent
number
net_gross_sales
number
net_gross_profit
number
sum_returned
number
sold_measurement_value
number
returned_measurement_value
number
sold_without_return
number
transaction_count
integer
orders_count
integer
average_cheque
number
average_measurement_value
number
average_price
number
net_sold_supply_sum
number
target
integer
rounding_amount
number
count
integer format: int32
Examplegenerated
{
  "seller_stats_by_date": [
    {
      "date": "example",
      "seller_id": "example",
      "seller_name": "example",
      "shop_id": "example",
      "shop_name": "example",
      "gross_sales": 1,
      "discount_sum": 1,
      "discount_percent": 1,
      "net_gross_sales": 1,
      "net_gross_profit": 1,
      "sum_returned": 1,
      "sold_measurement_value": 1,
      "returned_measurement_value": 1,
      "sold_without_return": 1,
      "transaction_count": 1,
      "orders_count": 1,
      "average_cheque": 1,
      "average_measurement_value": 1,
      "average_price": 1,
      "net_sold_supply_sum": 1,
      "rounding_amount": 1,
      "free_price": true,
      "used_wholesale_price": true,
      "target": 1
    }
  ],
  "sellers_stats_total": {
    "gross_sales": 1,
    "discount_sum": 1,
    "discount_percent": 1,
    "net_gross_sales": 1,
    "net_gross_profit": 1,
    "sum_returned": 1,
    "sold_measurement_value": 1,
    "returned_measurement_value": 1,
    "sold_without_return": 1,
    "transaction_count": 1,
    "orders_count": 1,
    "average_cheque": 1,
    "average_measurement_value": 1,
    "average_price": 1,
    "net_sold_supply_sum": 1,
    "target": 1,
    "rounding_amount": 1
  },
  "count": 1
}