Account
GET /v1/stats — Your Delivery and Refund Record
Your own order outcomes: delivered, refunded, refund rate, and measured delivery times — computed from your rows, not quoted from a slide.
GET
/
stats
Your own delivery and refund record
curl --request GET \
--url https://csboard.com/v1/stats \
--header 'Authorization: Bearer <token>'import requests
url = "https://csboard.com/v1/stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://csboard.com/v1/stats', 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://csboard.com/v1/stats",
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://csboard.com/v1/stats"
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))
}HttpResponse<String> response = Unirest.get("https://csboard.com/v1/stats")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://csboard.com/v1/stats")
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": {
"window_days": 123,
"since": "2023-11-07T05:31:56Z",
"orders_total": 123,
"delivered": 123,
"refunded": 123,
"cancelled_by_you": 123,
"in_flight": 123,
"refund_rate_pct": 123,
"delivery_minutes": {
"median": 123,
"p90": 123,
"samples": 123
}
}
}“What is your refund rate?” is worth nothing as a number we tell you — you cannot check it, and it describes our traffic rather than yours. This returns your outcomes over a window you choose: orders placed, delivered, refunded, and how long delivery actually took.
Two things about what the numbers mean:
- Held orders you cancelled yourself are not failures. Buying a held item and changing your mind before the hold clears is the feature working. They are reported separately as
cancelled_by_youand excluded fromrefund_rate_pct. - The denominator is settled orders only. An order still in flight has no outcome yet; counting it would make your rate drift down simply because you ordered recently.
refund_rate_pctisnulluntil you have at least one settled order.
Authorization: Bearer csb_pub_....Authorizations
Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile. Calls made with a key are metered only by that key's own limits — there is no per-IP limit on top — and every answer carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and X-RateLimit-Bucket for the bucket the call spent. See Rate limits.
Query Parameters
Window in days, 1-365 (default 30).
Required range:
1 <= x <= 365Response
Your record over the window.
Show child attributes
Show child attributes
⌘I
Your own delivery and refund record
curl --request GET \
--url https://csboard.com/v1/stats \
--header 'Authorization: Bearer <token>'import requests
url = "https://csboard.com/v1/stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://csboard.com/v1/stats', 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://csboard.com/v1/stats",
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://csboard.com/v1/stats"
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))
}HttpResponse<String> response = Unirest.get("https://csboard.com/v1/stats")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://csboard.com/v1/stats")
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": {
"window_days": 123,
"since": "2023-11-07T05:31:56Z",
"orders_total": 123,
"delivered": 123,
"refunded": 123,
"cancelled_by_you": 123,
"in_flight": 123,
"refund_rate_pct": 123,
"delivery_minutes": {
"median": 123,
"p90": 123,
"samples": 123
}
}
}