Show business figures
curl --request GET \
--url https://{host}/v1/sellers/{sellerId}/statistics \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{host}/v1/sellers/{sellerId}/statistics', 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://{host}/v1/sellers/{sellerId}/statistics",
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;
}import requests
url = "https://{host}/v1/sellers/{sellerId}/statistics"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"type": "seller-statistics",
"id": "42",
"attributes": {
"awaitingPayout": 1455000,
"paidOut": 900000,
"total": 2355000,
"ordersToFulfil": 1,
"unreadConversations": 3,
"favorites": 34
}
}
}{
"errors": [
{
"status": "404",
"code": "watch_reserved",
"title": "Not Found",
"detail": "<string>",
"meta": {},
"source": {
"pointer": "/data/attributes/reference",
"parameter": "<string>"
}
}
],
"jsonapi": {
"version": "1.0"
}
}{
"errors": [
{
"status": "404",
"code": "watch_reserved",
"title": "Not Found",
"detail": "<string>",
"meta": {},
"source": {
"pointer": "/data/attributes/reference",
"parameter": "<string>"
}
}
],
"jsonapi": {
"version": "1.0"
}
}Sellers
Show business figures
Scope: orders:read
The numbers a seller opens their dashboard for, in cents:
awaitingPayout | Sold and paid for, not yet paid out to them: what they will receive, subtotal + shipping - applicationFee summed — not the buyers’ totals, which hold the buyer’s service costs |
paidOut | What they have been paid, by the same rule |
total | Everything they have sold through us, as the buyers paid it (a sales figure, not a payout) |
ordersToFulfil | Orders waiting to be shipped |
unreadConversations | Threads waiting on them |
favorites | How many times anybody put one of their watches aside. A running total of attention over the whole catalogue, sold and withdrawn listings included — and the closest thing to “views” the platform records |
Only orders that were really paid are counted: a payment that never succeeded is not money anybody is waiting for.
For the business itself. Reading a shop page is one question and what that shop
has been paid is another, so anybody else gets 404.
The same figures come back as GET /v1/sellers/{sellerId}?include=statistics,
which is one call rather than two when you are drawing a dashboard. Asked that
way for a shop you do not act for, or by a token without orders:read, the
relationship is simply null.
GET
/
v1
/
sellers
/
{sellerId}
/
statistics
Show business figures
curl --request GET \
--url https://{host}/v1/sellers/{sellerId}/statistics \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{host}/v1/sellers/{sellerId}/statistics', 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://{host}/v1/sellers/{sellerId}/statistics",
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;
}import requests
url = "https://{host}/v1/sellers/{sellerId}/statistics"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"type": "seller-statistics",
"id": "42",
"attributes": {
"awaitingPayout": 1455000,
"paidOut": 900000,
"total": 2355000,
"ordersToFulfil": 1,
"unreadConversations": 3,
"favorites": 34
}
}
}{
"errors": [
{
"status": "404",
"code": "watch_reserved",
"title": "Not Found",
"detail": "<string>",
"meta": {},
"source": {
"pointer": "/data/attributes/reference",
"parameter": "<string>"
}
}
],
"jsonapi": {
"version": "1.0"
}
}{
"errors": [
{
"status": "404",
"code": "watch_reserved",
"title": "Not Found",
"detail": "<string>",
"meta": {},
"source": {
"pointer": "/data/attributes/reference",
"parameter": "<string>"
}
}
],
"jsonapi": {
"version": "1.0"
}
}Authorizations
oauth2bearerAuth