Catalogs

Query the reference catalogs available in Mexico. Use these endpoints to populate dropdowns and validate data when registering users or configuring accounts.

INFO

Service available in Mexico only.

Requirements

A valid account

An API key (sent in BP-Api-Key header)

Environments

Environment	Base URL
Dev	`https://v2.legacy.billpocket.com`
Live	`https://test.v2.legacy.billpocket.com`

States

GET /v2/estados

Returns the list of Mexican states with their IDs.

Response (excerpt):

[
  { "id": 1, "desc": "AGUASCALIENTES" },
  { "id": 2, "desc": "BAJA CALIFORNIA" }
]

Municipalities

GET /v2/estados/{ID_ESTADO}

Returns the municipalities for a given state. Pass the state id from the States endpoint as ID_ESTADO.

Response (excerpt):

[
  { "id": 1, "desc": "AGUASCALIENTES" },
  { "id": 2, "desc": "ASIENTOS" }
]

Tax companies

GET /v2/sociedades

Returns the list of legal entity types (tipos de sociedad) with abbreviations.

Response (excerpt):

[
  { "id": 1, "desc": "Sociedad Civil", "abrv": "S.C." },
  { "id": 2, "desc": "Asociación Civil", "abrv": "A.C." }
]

Commercial activities

GET /v2/giros

Returns the list of commercial activity types (giros comerciales).

Response (excerpt):

[
  { "id": 1, "desc": "Agencia de Viajes" },
  { "id": 2, "desc": "Agente de Seguros o Aseguradora" }
]

Next steps

Review the Catalogs API reference

Use catalog IDs when creating users

Got a suggestion on this documentation? Contact us.

Requirements#

Environments#

States#

Municipalities#

Tax companies#

Commercial activities#

Next steps#

Requirements

Environments

States

Municipalities

Tax companies

Commercial activities

Next steps