Errors and pagination | Taktoria API

Errors

Every non-2xx response has the same shape:

{
  "error": {
    "code": "steps_incomplete",
    "message": "3 required steps still need a decision.",
    "details": { "steps": [{ "id": "stp_1", "name": "Privacy Review", "status": "NOT_STARTED" }] }
  }
}

Status	Code	Meaning
401	`unauthorized`	Missing, invalid, expired or revoked key
402	`subscription_required`	No active subscription for that app
403	`insufficient_scope`	The key lacks the scope this endpoint needs
404	`not_found`	No such resource in your organization
409	`steps_incomplete`, `seat_limit_reached`	The request conflicts with current state
422	`validation_error`	The body failed validation; `details` holds the issues

Pagination

List endpoints are cursor-paginated:

curl "https://app.taktoria.com/api/v1/launches?limit=50&cursor=lch_7f3a" \
  -H "Authorization: Bearer $TAKTORIA_API_KEY"

{ "data": [], "nextCursor": "lch_9c1b", "hasMore": true }

Pass nextCursor as the next request’s cursor. limit defaults to 50 and caps at 200.