Skip to content
KasblyKasbly Docs

List billings for an order

GET
/api/v1/billing/order/{orderId}
curl --request GET \
  --url https://api.dokanmazad.com/api/v1/billing/order/cmosor2zy000313ny24hgtfy0 \
  --header 'X-API-Key: <X-API-Key>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
orderId
required
string

Order CUID

Example
cmosor2zy000313ny24hgtfy0

Responses

Section titled “Responses”

200

Section titled “200”

Success

Media typeapplication/json
object
success
required
boolean
data
required
meta
object
page
integer
limit
integer
total
integer
totalPages
integer
data
required
object
id
required

Billing CUID

string
orderId
required

Parent order CUID

string
amount
required

Billing amount

number
currency
required

ISO 4217 currency code

string
type
required

Document type — invoice | receipt

string
status
required

Billing status — Pending | Confirmed | Rejected

string
description

Human-readable payment description

string
items

Line items array — each item: { type, description, amount }

Array
receiptFileUrl

URL of uploaded receipt/proof-of-payment document

string
createdAt
required

Creation timestamp

string format: date-time
Examples
Examplesuccess
{
  "success": true,
  "data": [
    {
      "id": "cmbill00000001ny11aabbcc0",
      "orderId": "cmosor2zy000313ny24hgtfy0",
      "amount": 5000,
      "currency": "USD",
      "type": "invoice",
      "status": "Pending",
      "description": "Deposit payment for BMW 3 Series",
      "items": [
        {
          "type": "deposit",
          "description": "Initial deposit",
          "amount": 3000
        },
        {
          "type": "fee",
          "description": "Processing fee",
          "amount": 200
        }
      ],
      "receiptFileUrl": null,
      "createdAt": "2026-05-01T09:00:00.000Z"
    }
  ]
}

401

Section titled “401”

Unauthorized — missing or invalid API key

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

403

Section titled “403”

Forbidden — route not in this key’s allowedRoutes

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

429

Section titled “429”

Rate limit exceeded

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying