Obtener el banco de una Tarjeta

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

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`	Atributos 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 oficial de la institución bancaria. 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` si se desconoce. p. ej. `VISA`
`card_type`	`string \| null`anulable	Tipo de tarjeta (CREDIT, DEBIT, PREPAID, …), o `null` si se desconoce. p. ej. `CREDIT`
`card_level`	`string \| null`anulable	Nivel de la tarjeta (GOLD, PLATINUM, …), o `null` si 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. `a1b2c3d4e5f6`
`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 `e6f7a8b9c0d1`
429	`rate_limit_exceeded`	Límite de peticiones excedido. Inténtalo de nuevo en 45 segundos. Envelope meta.request_id `f7a8b9c0d1e2` 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 (emitido sólo en 429). `X-RateLimit-Remaining`: integer — Solicitudes restantes en la ventana actual — siempre 0 en el momento del 429 (emitido sólo en 429). `X-RateLimit-Reset`: integer — Unix epoch absoluto (segundos) en que se reinicia la ventana. Emitido sólo en 429, junto con Retry-After. Puede existir sobreescritura por endpoint (p. ej. `rate_limited_login`).