Tikin · Docs
API ReferenceMoneyMovements

El historial de una cuenta

GET
/v1/accounts/{account_id}/movements

Los movimientos contables, del más reciente al más viejo, paginados por cursor. Con ?expand=counterparty cada counterparty trae además alias, display_name y type — un viaje en vez de N. Lo que no se pueda resolver queda como {account_id}: un nombre que no se pudo verificar no se inventa.

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

Path Parameters

account_id*string
Formatuuid

Query Parameters

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

El next_cursor de la página anterior.

expand?"counterparty"

Qué recurso relacionado incluir entero. Catálogo cerrado; un valor desconocido es 400 invalid_field.

Value in

  • "counterparty"
asset?string

COPM = centavos de peso (escala 2) · DUSD = millonésimas de dólar (escala 6).

Value in

  • "COPM"
  • "DUSD"
kind?string

El sufijo dice la dirección, siempre.

Value in

  • "transfer_in"
  • "transfer_out"
  • "bonus_in"
  • "bonus_out"
  • "payin_in"
  • "payout_out"
  • "fee_out"
  • "adjustment_in"
  • "adjustment_out"
created_at[gte]?string
Formatdate-time
created_at[lte]?string
Formatdate-time

Header Parameters

Tikin-Version?string

La versión del contrato a la que anclas este pedido, como fecha YYYY-MM-DD. Rige la última publicada en o antes de esa fecha; sin el header, la más reciente.

Formatdate

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/movements"
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "kind": "transfer_in",      "amount": {        "raw": "string",        "asset": "COPM"      },      "counterparty": {        "account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",        "tenant": "string",        "alias": "string",        "display_name": "string",        "type": "person"      },      "description": "string",      "related": {        "type": "transfer",        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"      },      "created_at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "string"}