TuCapiDocs

API reference

Statements

Monthly summaries of the fees we deducted. They are not tax invoices.

Endpoints

The Statement object

Object fields, as the API returns them.

  • objectstring
    Always statement.
  • idstring (uuid)
    Statement id.
  • numberstring
    Sequential number, e.g. CBI-2026-000003.
  • periodstring
    Month, as YYYY-MM.
  • periodStartstring (date-time)
    Period start.
  • periodEndstring (date-time)
    Period end (exclusive).
  • currencystring
    Always USDT.
  • orderCountinteger
    Orders included.
  • grossAmountstring (decimal)
    Gross amount collected.
  • feeAmountstring (decimal)
    Total fees.
  • issuerobject
    Entity that issues the statement.
  • issuer.entitystring
    Entity code.
    Possible values:CAIBO_INCTUCAPI_LLC
  • issuer.namestring
    Legal name.
  • issuedAtstring (date-time)
    When it was issued.
  • pdfUrlstring
    PDF path, relative to the base URL.
  • linesobject[]
    One line per order. Only in GET /statements/{id}.
  • lines[].orderIdstring (uuid)Nullable
    Order id.
  • lines[].merchantOrderRefstring
    Order reference.
  • lines[].paymentMethodstring
    Payment method.
    Possible values:paypalzellecard
  • lines[].paidAtstring (date-time)
    When it was paid.
  • lines[].grossAmountstring (decimal)
    Gross amount.
  • lines[].feeRatestring
    Rate as a fraction ("0.05" is 5%).
  • lines[].fixedFeestring (decimal)
    Fixed fee.
  • lines[].feeAmountstring (decimal)
    Fee for the order.
The Statement object
JSON
{  "object": "statement",  "id": "5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d",  "number": "CBI-2026-000003",  "period": "2026-08",  "periodStart": "2026-08-01T00:00:00Z",  "periodEnd": "2026-09-01T00:00:00Z",  "currency": "USDT",  "orderCount": 12,  "grossAmount": "1480.00",  "feeAmount": "77.60",  "issuer": {    "entity": "CAIBO_INC",    "name": "Caibo Inc."  },  "issuedAt": "2026-09-01T06:00:12Z",  "pdfUrl": "/v1/statements/5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d/pdf",  "lines": [    {      "orderId": "c9227f9b-13f4-4e9c-8fe0-4644e62b83cd",      "merchantOrderRef": "MO-k7x2m9qz-1a2b3c4d",      "paymentMethod": "paypal",      "paidAt": "2026-08-14T15:20:11Z",      "grossAmount": "125.00",      "feeRate": "0.035",      "fixedFee": "0.30",      "feeAmount": "4.68"    }  ]}

List statements

GET/v1/statements

Newest first, at most one per month. Not paginated: returns up to 120 in one response.

Scopestatements:read

Returns

Returns a paginated list of Statement objects.

Error responses

401403429
curl "https://api.business.tucapi.com/v1/statements" \  -H "Authorization: Bearer $TUCAPI_KEY"
200 Response
JSON
{  "object": "list",  "data": [    {      "object": "statement",      "id": "5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d",      "number": "CBI-2026-000003",      "period": "2026-08",      "periodStart": "2026-08-01T00:00:00Z",      "periodEnd": "2026-09-01T00:00:00Z",      "currency": "USDT",      "orderCount": 12,      "grossAmount": "1480.00",      "feeAmount": "77.60",      "issuer": {        "entity": "CAIBO_INC",        "name": "Caibo Inc."      },      "issuedAt": "2026-09-01T06:00:12Z",      "pdfUrl": "/v1/statements/5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d/pdf"    }  ],  "hasMore": false,  "nextCursor": null}

Retrieve a statement

GET/v1/statements/{id}

Returns the statement with its lines, one per paid order.

Scopestatements:read

Path parameters

  • idstring (uuid)Required
    Resource id (UUID).

Returns

Returns a Statement object.

Error responses

401403404429
curl "https://api.business.tucapi.com/v1/statements/5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d" \  -H "Authorization: Bearer $TUCAPI_KEY"
200 Response
JSON
{  "object": "statement",  "id": "5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d",  "number": "CBI-2026-000003",  "period": "2026-08",  "periodStart": "2026-08-01T00:00:00Z",  "periodEnd": "2026-09-01T00:00:00Z",  "currency": "USDT",  "orderCount": 12,  "grossAmount": "1480.00",  "feeAmount": "77.60",  "issuer": {    "entity": "CAIBO_INC",    "name": "Caibo Inc."  },  "issuedAt": "2026-09-01T06:00:12Z",  "pdfUrl": "/v1/statements/5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d/pdf",  "lines": [    {      "orderId": "c9227f9b-13f4-4e9c-8fe0-4644e62b83cd",      "merchantOrderRef": "MO-k7x2m9qz-1a2b3c4d",      "paymentMethod": "paypal",      "paidAt": "2026-08-14T15:20:11Z",      "grossAmount": "125.00",      "feeRate": "0.035",      "fixedFee": "0.30",      "feeAmount": "4.68"    }  ]}

Download the PDF

GET/v1/statements/{id}/pdf

Returns the statement as a PDF (Content-Type: application/pdf).

Scopestatements:read

Path parameters

  • idstring (uuid)Required
    Resource id (UUID).

Returns

Returns the PDF file.

Error responses

401403404429
curl -o CBI-2026-000003.pdf "https://api.business.tucapi.com/v1/statements/5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d/pdf" \  -H "Authorization: Bearer $TUCAPI_KEY"
200 Response
PDF
HTTP/1.1 200 OKContent-Type: application/pdf​%PDF-1.7 …