GEThttps://api.veriko.mx/v1/public/bin-lookup/{bin}

Obtener el banco de una Tarjeta

Audiencia: public

Resuelve el banco emisor de una tarjeta bancaria a partir de su BIN (Bank Identification Number).

Acepta de 6 a 16 dígitos, aunque solo se usan los primeros 6-8. El BIN que aparece en la respuesta, es el prefijo que coincidió en la búsqueda, junto con la información de la institución bancaria.

El banxico_code devuelto es el código de 5 dígitos que identifica a cada institución bancaria participante de SPEI.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`bin`*	path	`string`	obligatorio	BIN o número de tarjeta (6 a 16 dígitos). Solo se usan los primeros 6-8. p. ej. `45320151`

Petición

cURLPythonJavaScriptPHP

curl -X GET 'https://api.veriko.mx/v1/public/bin-lookup/{bin}'

import requests

bin = "424242"
response = requests.get(f"https://api.veriko.mx/v1/public/bin-lookup/{bin}")
print(response.json())

const bin = "424242";

fetch(`https://api.veriko.mx/v1/public/bin-lookup/${bin}`)
  .then(response => response.json())
  .then(data => console.log(data));

<?php

$bin = "424242";
$ch = curl_init("https://api.veriko.mx/v1/public/bin-lookup/$bin");

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

**Respuesta 200**`BinLookupResponse` — Información del BIN: Banco emisor y metadatos.
Campo	Tipo	Descripción
`data`	`object`	Payload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con `type`, `id`, `attributes`).
`type`*	`string`	Tipo del recurso API (`bin_lookup` por defecto). p. ej. `bin_lookup`
`id`*	`string`	BIN (6-8 dígitos) que coincidió en la búsqueda. p. ej. `45320151`
`attributes`*	`object`	Datos del BIN y del banco asociado.
`bin`*	`string`	BIN (6-8 dígitos) que coincidió en la búsqueda (mismo valor que `id`). p. ej. `45320151`
`bank_name`*	`string`	Nombre del banco registrado para ese BIN. p. ej. `BBVA MEXICO`
`banxico_code`*	`string \| null`anulable	Código de la institución bancaria ante el sistema SPEI (5 dígitos), o `null` cuando el banco no es participante SPEI (ej: Amex). p. ej. `40012`
`card_brand`	`string \| null`anulable	Red de la tarjeta (VISA, MASTERCARD, …), o `null` cuando se desconoce. p. ej. `VISA`
`card_type`	`string \| null`anulable	Tipo de tarjeta (CREDIT, DEBIT, PREPAID, …), o `null` cuando se desconoce. p. ej. `CREDIT`
`card_level`	`string \| null`anulable	Nivel de la tarjeta (GOLD, PLATINUM, …), o `null` cuando se desconoce. p. ej. `GOLD`
`country_iso`*	`string`	Código del país emisor (en ISO-3166 alpha-2). p. ej. `MX`
`meta`	`object`	Metadatos de la respuesta, incluyendo versión de la API, prefijo de ruta, identificador único de la petición y marca temporal del servidor en UTC.
`version`	`string`	Versión de la API que procesó la petición. p. ej. `1.47.0`
`api_version`	`string`	Versión del prefijo de ruta de la API (ej. `v1`). p. ej. `v1`
`request_id`	`string`	Identificador único de la petición (hex). p. ej. `a1b2c3d4e5f66f5e4d3c2b1a`
`datetime`	`object`	Descriptor compañero presente en el bloque `meta` de cada respuesta (y en el `meta` del cuerpo de los webhooks salientes). Permite a los clientes afirmar el contrato de zona horaria sin releer el spec. p. ej. `{"timezone":"UTC","format":"ISO 8601"}`
`timezone`*	`string`	Siempre `UTC`: La zona canónica para cada campo datetime del cuerpo. p. ej. `UTC`
`format`*	`string`	Siempre `ISO 8601`: Sufijo `Z` explícito en cada datetime. p. ej. `ISO 8601`
`links`	`object`	Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.

**Códigos de respuesta**`GET /v1/public/bin-lookup/{bin}`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Información del BIN: Banco emisor y metadatos.	`BinLookupResponse`
404	`4xx`	El recurso no existe o no es visible para el cliente	`Error`
422	`4xx`	Falló la validación de la petición	`ErrorResponse`
429	`4xx`	Límite de tasa excedido	`ErrorResponse`

**Errores de `GET /v1/public/bin-lookup/{bin}`**
Código	Clave	Ejemplo
422	`validation_error`	El campo fecha es obligatorio. Envelope source.pointer `/data/attributes/fecha` meta.request_id `e6f7a8b9c0d11d0c9b8a7f6e`
429	`rate_limit_exceeded`	Límite de peticiones excedido. Inténtalo de nuevo en 45 segundos. Envelope meta.request_id `f7a8b9c0d1e22e1d0c9b8a7f` Cabeceras de respuesta `Retry-After`: integer — Segundos a esperar antes de reintentar. Coincide con la ventana de rate-limit del endpoint (típicamente 60s para listas, 1-5s para operaciones idempotentes en vuelo). `X-RateLimit-Limit`: integer — Límite de solicitudes configurado para este bucket. Se emite en cada 429 y, en la API autenticada, también en las respuestas correctas, donde es el tope por clave del plan de la cuenta. `X-RateLimit-Remaining`: integer — Solicitudes restantes en la ventana actual. Siempre 0 en el momento del 429; en una respuesta correcta de la API autenticada es lo que queda del tope por clave. `X-RateLimit-Reset`: integer — Unix epoch absoluto (segundos) en que se reinicia la ventana. Se emite en cada 429, junto con Retry-After, y en las respuestas correctas de la API autenticada. Puede existir sobreescritura por endpoint (p. ej. `rate_limited_login`).