Tikin · Docs
API ReferenceAccounts

Resolver un destinatario

GET
/v1/accounts/lookup

Resuelve un alias de TU tenant (único dentro del tenant; el formato — como el $ de Tikin — lo define cada tenant) o un teléfono a lo mínimo para confirmar un envío. Exactamente UNO de alias o phone; los dos, o ninguno, es 400 missing_query. Para destinatarios de otro tenant, arma el destino cross-tenant con el par tenant + alias.

Requiere el scope lookup y tiene rate limit propio y agresivo: es un directorio de personas, no un buscador. Para person, display_name llega abreviado ("Ana P."); el nombre legal completo solo para business.

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

alias?string
phone?string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/accounts/lookup"
{  "account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",  "tenant": "string",  "alias": "string",  "display_name": "string",  "type": "person"}