Kardlane
API Reference

Retrieve a trade

GEThttps://api.kardlane.com/v1/trades/{id}

The current state of a trade: status, vendor, rates, the bot’s status, and — when it needs review — the same review block the escalation webhook carries.

Authorization#

Authorizationheaderrequired

Bearer token: Bearer <your project API key>. Create keys in the dashboard under your project’s Integration page.

Path parameters#

idstringrequired

The tradeId returned when you created the trade.

Responses#

200The trade.
404Not a trade in this project.
curl https://api.kardlane.com/v1/trades/6abea25d-0c1f-4a43-9d1e-3b5c2f0edad5 \
  -H "Authorization: Bearer $KARDLANE_API_KEY"
{
  "tradeId": "6abea25d-0c1f-4a43-9d1e-3b5c2f0edad5",
  "externalRef": "sale_8213",
  "status": "UPLOADED",
  "cardType": "APPLE_ITUNES",
  "country": "USD",
  "value": 150,
  "customerRate": 1080,
  "vendorRate": 1150,
  "margin": 70,
  "vendor": "Vendor Alpha",
  "bot": {
    "state": "working",
    "pausedAt": null,
    "pausedBy": null,
    "pauseScope": null,
    "stoppedAt": null,
    "stoppedBy": null,
    "canPause": true,
    "canResume": false,
    "canStop": true,
    "resumeBlocked": null
  },
  "createdAt": "2026-10-03T09:12:44.120Z",
  "updatedAt": "2026-10-03T09:15:02.881Z"
}