Tikin · Docs
API ReferenceServicesBonuses

Listar lotes

GET
/v1/bonus_batches

Los lotes de bonos con su estado.

Authorization

tenantToken
AuthorizationBearer <token>

Tu token de tenant: tk_live_…. El entorno sandbox llega pronto; los tokens tk_test_ quedarán reservados para él. Scopes: read, lookup, transfers, bonuses, payouts, webhooks. Usa el mínimo.

In: header

Query Parameters

limit?integer
Range1 <= value <= 100
Default25
cursor?string

El next_cursor de la página anterior.

status?string

Value in

  • "validating"
  • "ready"
  • "rejected"
  • "executing"
  • "completed"
  • "partially_failed"
  • "canceled"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/bonus_batches"
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "status": "validating",      "source_account": "0b96a69a-83bf-4bb3-9b52-1bfb05c01fa0",      "rows": 0,      "rows_rejected": 0,      "total": {        "raw": "string",        "asset": "COPM"      },      "description": "string",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "string"}