curl "https://client.tukanmx.com/tukan-atlas/institution-entities/?search=oxxo" \
-H "Authorization: Token $API_TUKAN"
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.get(
"https://client.tukanmx.com/tukan-atlas/institution-entities/",
headers=headers,
params={"search": "oxxo"},
)
resp.raise_for_status()
for inst in resp.json()["results"]:
print(inst["id"], inst["name"])
{
"count": 1,
"page": 1,
"page_size": 100,
"results": [
{
"id": "CCO8605231N4.MX",
"name": "Cadena Comercial OXXO",
"name_en": "Cadena Comercial OXXO",
"legal_name": "Cadena Comercial OXXO, S.A. de C.V."
}
]
}
Catálogos
Instituciones
Las empresas dueñas de las marcas mapeadas en Atlas, identificadas por RFC.
GET
/
institution-entities
/
curl "https://client.tukanmx.com/tukan-atlas/institution-entities/?search=oxxo" \
-H "Authorization: Token $API_TUKAN"
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.get(
"https://client.tukanmx.com/tukan-atlas/institution-entities/",
headers=headers,
params={"search": "oxxo"},
)
resp.raise_for_status()
for inst in resp.json()["results"]:
print(inst["id"], inst["name"])
{
"count": 1,
"page": 1,
"page_size": 100,
"results": [
{
"id": "CCO8605231N4.MX",
"name": "Cadena Comercial OXXO",
"name_en": "Cadena Comercial OXXO",
"legal_name": "Cadena Comercial OXXO, S.A. de C.V."
}
]
}
Las empresas dueñas de las marcas, identificadas por un ID tipo RFC. Una institución puede operar varias marcas.
Usa su
id para filtrar por grupo corporativo completo en listado por entidad (filters.institution_ids), o para listar sus marcas en marcas.
curl "https://client.tukanmx.com/tukan-atlas/institution-entities/?search=oxxo" \
-H "Authorization: Token $API_TUKAN"
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.get(
"https://client.tukanmx.com/tukan-atlas/institution-entities/",
headers=headers,
params={"search": "oxxo"},
)
resp.raise_for_status()
for inst in resp.json()["results"]:
print(inst["id"], inst["name"])
{
"count": 1,
"page": 1,
"page_size": 100,
"results": [
{
"id": "CCO8605231N4.MX",
"name": "Cadena Comercial OXXO",
"name_en": "Cadena Comercial OXXO",
"legal_name": "Cadena Comercial OXXO, S.A. de C.V."
}
]
}
Autorizaciones
Token de autenticación. Formato requerido: Token tu-token (la palabra Token, un espacio y tu token). Solicita tu token escribiendo a contacto@tukanmx.com.
Parámetros de consulta
Número de página
Resultados por página
Búsqueda global en id, name, name_en y legal_name
Ejemplo:
"hsbc"
ID exacto de la institución (tipo RFC)
Ejemplo:
"FAR970429SE2.MX"
Filtro por nombre de la institución (coincidencia parcial)
Ejemplo:
"banco"
Filtro por razón social en inglés (coincidencia parcial)
Filtro por razón social (coincidencia parcial)
Ejemplo:
"HSBC"
¿Esta página le ayudó?