API reference

Wallet

Balances and every wallet entry.

get/walletAvailable, pending and held balances get/wallet/transactionsLedger entries, newest first, each linked to its order

Available, pending and held balances

get/wallet

Example request

curl "https://backend.markitmall.com/dropship/v1/wallet" \
  -H "Authorization: Bearer mk_test_XXXX:sk_test_XXXX"

Response 200

Wallet

`available` integer	—
`pending` integer	Margins waiting for their release date (20 days after delivery)
`pendingOrders` integer	—
`held` integer	Deposit + RTO reserves
`heldDeposit` integer	—
`heldReserve` integer	—
`depositRequired` integer	—
`withdrawalsPending` integer	—
`currency` "PKR"	—

Example response

JSON

{
  "available": 0,
  "pending": 0,
  "pendingOrders": 0,
  "held": 0,
  "heldDeposit": 0,
  "heldReserve": 0,
  "depositRequired": 0,
  "withdrawalsPending": 0,
  "currency": "PKR"
}

Errors: 401 — the body is always { error: { code, message, details } }.

Ledger entries, newest first, each linked to its order

get/wallet/transactions

Parameters

`type` query · string
`limit` query · integer	Default 50
`cursor` query · string	`nextCursor` from the previous page

Example request

curl "https://backend.markitmall.com/dropship/v1/wallet/transactions" \
  -H "Authorization: Bearer mk_test_XXXX:sk_test_XXXX"

Response 200

`data`required LedgerEntry[]	—
`nextCursor`required string \| null	—

Example response

JSON

{
  "data": [
    {
      "id": "66f0c2a1b2c3d4e5f6a7b8c9",
      "amount": 1500,
      "type": "string",
      "status": "string",
      "description": "string",
      "createdAt": "2026-10-06T10:00:00.000Z",
      "order": {}
    }
  ],
  "nextCursor": "string"
}

Errors: 401 — the body is always { error: { code, message, details } }.