Consultar un beneficiario

GET/beneficiaries/{id}Probar

URL base

API key x-api-keyRecordar la clave en este navegador (localStorage, no sale de aquí)

Parámetros de ruta

idstringobligatorio

Enviar peticiónCopiar como curl

La llamada la hace tu navegador, contra el servidor que elijas arriba. Si la documentación no está servida desde el mismo origen que la API, el navegador puede bloquear la respuesta por CORS: en ese caso abre estas páginas desde la propia API (/docs) o usa el curl de arriba.

GET

/beneficiaries/{id}

curl --request GET \
  --url http://localhost:3000/v1/beneficiaries/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'x-api-key: <x-api-key>'

• Pruebas (sandbox)
• Producción

Scope beneficiaries:read. payout_count, last_success_at y last_failure_reason son el historial del destinatario: sirven para decidir si un pago nuevo a esa persona es rutinario o merece una revisión.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

200

Beneficiario

Media typeapplication/json

object

id

string format: uuid

full_name

string

national_id

string

bank_code

string

account_number

string

nullable

phone

string

nullable

asset

string

Allowed values: BS USD USDC VESC

country

string

status

string

Allowed values: active blocked

payout_count

Cuántas dispersiones le han llegado bien. Señal antifraude.

integer

last_success_at

string format: date-time

nullable

last_failure_reason

string

nullable

created_at

string format: date-time

Example

{
  "asset": "BS",
  "status": "active"
}

404

Error con código estable

Media typeapplication/json

object

error

object

meta

Contexto estructurado del error cuando lo hay: qué límite se superó y de cuánto, qué campo es inválido, cuánto saldo había. No aparece en errores internos.

object

key

additional properties

any

type

string

Allowed values: invalid_request_error authentication_error rate_limit_error provider_error api_error

code

Código ESTABLE. Programa contra esto.

string

message

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_balance",
    "request_id": "req_8a0312ba896772bc441134cd"
  }
}

422

Error con código estable

Media typeapplication/json

object

error

object

meta

Contexto estructurado del error cuando lo hay: qué límite se superó y de cuánto, qué campo es inválido, cuánto saldo había. No aparece en errores internos.

object

key

additional properties

any

type

string

Allowed values: invalid_request_error authentication_error rate_limit_error provider_error api_error

code

Código ESTABLE. Programa contra esto.

string

message

string

request_id

string

Example

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_balance",
    "request_id": "req_8a0312ba896772bc441134cd"
  }
}