Introducción

    API Endpoint

        https://api.tau.com.mx/dipomex/v1/

Directorio Postal Mexicano, DIPOMEX API provee información de códigos postales de México, esta versión es gratuita.

Para usar esta API, necesitas una APIKEY. La puedes obtener en el siguiente link: OBTENER APIKEY.

BUSCAR CP


# Aquí hay un ejemplo de petición curl
curl \ 
-X GET \ 
-k \
-H 'APIKEY: tu_APIKEY' \ 
-i 'https://api.tau.com.mx/dipomex/v1/codigo_postal?cp=09000' \

Para obtener las colonias correspondientes a un Código Postal se necesita hacer una petición GET a la siguiente url:

https://api.tau.com.mx/dipomex/v1/codigo_postal 



Ejemplo de Respuesta:

{
  "error": false,
  "message": "Procesamiento correcto.",
  "codigo_postal": {
    "estado_id": "09",
    "municipio_id": "007",
    "estado": "CIUDAD DE MEXICO",
    "estado_abreviatura": "CMX",
    "municipio": "IZTAPALAPA",
    "centro_reparto": "09081",
    "codigo_postal": "09000",
    "colonias": [{
      "colonia_id": "763",
      "colonia": "La Asunción"
    }, {
      "colonia_id": "764",
      "colonia": "San Ignacio"
    }, {
      "colonia_id": "765",
      "colonia": "San José"
    }, {
      "colonia_id": "766",
      "colonia": "San Lucas"
    }, {
      "colonia_id": "767",
      "colonia": "San Pablo"
    }, {
      "colonia_id": "768",
      "colonia": "San Pedro"
    }, {
      "colonia_id": "769",
      "colonia": "Santa Bárbara"
    }]
  }
}

Parámetros

Campo Tipo Descripción
APIKEY String Tu API key enviada como HEADER.
cp String Código Postal a Consultar usando GET.

OBTENER ESTADO


# Aquí hay un ejemplo de petición curl
curl \ 
-X GET \ 
-k \
-H 'APIKEY: tu_APIKEY' \ 
-i 'https://api.tau.com.mx/dipomex/v1/estado?id=09' \

Para obtener los detalles de un Estado por ID se necesita hacer una petición GET a la siguiente url:

https://api.tau.com.mx/dipomex/v1/estado 



Ejemplo de Respuesta:

{
  "error": false,
  "message": "Estado cargado: 1",
  "estado": [{
    "ESTADO_ID": "09",
    "ESTADO": "CIUDAD DE MEXICO",
    "EDO1": "CMX",
    "RANGO1": "01000",
    "RANGO2": "19999"
  }]
}

Parámetros

Campo Tipo Descripción
APIKEY String Tu API key enviada como HEADER.
id String ID de estado usando GET.

OBTENER ESTADOS


# Aquí hay un ejemplo de petición curl
curl \ 
-X GET \ 
-k \
-H 'APIKEY: tu_APIKEY' \ 
-i 'https://api.tau.com.mx/dipomex/v1/estados' \

Para obtener todos los Estados se requiere hacer una petición GET a la siguiente url:

https://api.tau.com.mx/dipomex/v1/estados 



Ejemplo de Respuesta:

{
  "error": false,
  "message": "Estados cargados: 32",
  "estados": [{
    "ESTADO_ID": "01",
    "ESTADO": "AGUASCALIENTES",
    "EDO1": "AGS",
    "RANGO1": "20000",
    "RANGO2": "20999"
  }, {
    "ESTADO_ID": "02",
    "ESTADO": "BAJA CALIFORNIA",
    "EDO1": "BC",
    "RANGO1": "21000",
    "RANGO2": "22999"
  }, {
    "ESTADO_ID": "03",
    "ESTADO": "BAJA CALIFORNIA SUR",
    "EDO1": "BCS",
    "RANGO1": "23000",
    "RANGO2": "23999"
  }, {
    "ESTADO_ID": "04",
    "ESTADO": "CAMPECHE",
    "EDO1": "CAM",
    "RANGO1": "24000",
    "RANGO2": "24999"
  }, {
    "ESTADO_ID": "07",
    "ESTADO": "CHIAPAS",
    "EDO1": "CHS",
    "RANGO1": "29000",
    "RANGO2": "30999"
  }, {
    "ESTADO_ID": "08",
    "ESTADO": "CHIHUAHUA",
    "EDO1": "CHI",
    "RANGO1": "31000",
    "RANGO2": "33999"
  }, {
    "ESTADO_ID": "09",
    "ESTADO": "CIUDAD DE MEXICO",
    "EDO1": "CMX",
    "RANGO1": "01000",
    "RANGO2": "19999"
  }]
}

Parámetros

Campo Tipo Descripción
APIKEY String Tu API key enviada como HEADER.

OBTENER MUNICIPIOS


# Aquí hay un ejemplo de petición curl
curl \ 
-X GET \ 
-k \
-H 'APIKEY: tu_APIKEY' \ 
-i 'https://api.tau.com.mx/dipomex/v1/municipios?id_estado=09' \

Para obtener los Municipios correspondientes a un Estado por ID se necesita hacer una petición GET a la siguiente url:

https://api.tau.com.mx/dipomex/v1/municipios 



Ejemplo de Respuesta:

{
  "error": false,
  "message": "Municipios cargados: 16",
  "municipios": [{
    "ESTADO_ID": "09",
    "MUNICIPIO_ID": "010",
    "MUNICIPIO": "ALVARO OBREGON",
    "RANGO1": "01000",
    "RANGO2": "01999"
  }, {
    "ESTADO_ID": "09",
    "MUNICIPIO_ID": "002",
    "MUNICIPIO": "AZCAPOTZALCO",
    "RANGO1": "02000",
    "RANGO2": "02999"
  }, {
    "ESTADO_ID": "09",
    "MUNICIPIO_ID": "014",
    "MUNICIPIO": "BENITO JUAREZ",
    "RANGO1": "03000",
    "RANGO2": "03999"
  }, {
    "ESTADO_ID": "09",
    "MUNICIPIO_ID": "003",
    "MUNICIPIO": "COYOACAN",
    "RANGO1": "04000",
    "RANGO2": "04999"
  }, {
    "ESTADO_ID": "09",
    "MUNICIPIO_ID": "004",
    "MUNICIPIO": "CUAJIMALPA DE MORELOS",
    "RANGO1": "05000",
    "RANGO2": "05999"
  }]
}

Parámetros

Campo Tipo Descripción
APIKEY String Tu API key enviada como HEADER.
id_estado String ID de estado usando GET.

OBTENER COLONIAS


# Aquí hay un ejemplo de petición curl
curl \ 
-X GET \ 
-k \
-H 'APIKEY: tu_APIKEY' \ 
-i 'https://api.tau.com.mx/dipomex/v1/colonias?id_estado=09&id_mun=014' \

Para obtener las colonias de un Municipio de cierto Estado se necesita hacer una petición GET a la siguiente url:

https://api.tau.com.mx/dipomex/v1/colonias 



Ejemplo de Respuesta:

{
  "error": false,
  "message": "Colonias cargadas: 53",
  "colonias": [{
    "COLONIA_ID": "357",
    "ESTADO_ID": "09",
    "MUNICIPIO_ID": "014",
    "COLONIA": "8 de Agosto",
    "CP": "03820",
    "CR": "03901",
    "FECHA_ACT": "2021-02-21 22:09:24"
  }, {
    "COLONIA_ID": "321",
    "ESTADO_ID": "09",
    "MUNICIPIO_ID": "014",
    "COLONIA": "Acacias",
    "CP": "03240",
    "CR": "03001",
    "FECHA_ACT": "2021-02-21 22:09:24"
  }, {
    "COLONIA_ID": "320",
    "ESTADO_ID": "09",
    "MUNICIPIO_ID": "014",
    "COLONIA": "Actipan",
    "CP": "03230",
    "CR": "03001",
    "FECHA_ACT": "2021-02-21 22:09:24"
  }, {
    "COLONIA_ID": "328",
    "ESTADO_ID": "09",
    "MUNICIPIO_ID": "014",
    "COLONIA": "Álamos",
    "CP": "03400",
    "CR": "03501",
    "FECHA_ACT": "2021-02-21 22:09:24"
  }, {
    "COLONIA_ID": "339",
    "ESTADO_ID": "09",
    "MUNICIPIO_ID": "014",
    "COLONIA": "Albert",
    "CP": "03560",
    "CR": "03501",
    "FECHA_ACT": "2021-02-21 22:09:24"
  }, {
    "COLONIA_ID": "344",
    "ESTADO_ID": "09",
    "MUNICIPIO_ID": "014",
    "COLONIA": "Américas Unidas",
    "CP": "03610",
    "CR": "03501",
    "FECHA_ACT": "2021-02-21 22:09:24"
  }]
}
}

Parámetros

Campo Tipo Descripción
APIKEY String Tu API key enviada como HEADER.
id_estado String ID de estado usando GET.
id_mun String ID de municipio usando GET.

ERRORES

DIPOMEX API utiliza los siguientes códigos de error:

Código de Error Descripción
X000 Parámetros requeridos no proporcionados o están vacíos. Este error aparece cuando no se proporcionaron parámetros requeridos en la petición.
X001 Falta APIKEY de autorizacion. Este error aparece si no se proporcionó una API KEY en la petición.
X002 Acceso denegado. APIKEY no valida. No se encontró la API KEY proporcionada o se encuentra inactiva.
t