Consulta Ubigeos

Catálogo completo de ubigeos SUNAT como árbol departamento → provincia → distrito.

Consideraciones

Devuelve el catálogo completo de ubigeos SUNAT en forma de árbol jerárquico (departamento → provincia → distrito).
No disponible en el plan gratuito. Consume 2 consultas de tu plan.

POST https://api.apiperu.dev/ubigeos Copiar

Headers

Name	Type	Description
Accept	String	application/json
Content-Type	string	application/json
Authorization	string	Bearer <token>. Genéralo desde tu panel, en `Api Tokens`.

Ejemplo de solicitud

Copiar

curl -X POST https://api.apiperu.dev/ubigeos \
  -H "Accept: application/json" \
  -H "Authorization: Bearer TU_TOKEN"

Copiar

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.apiperu.dev/ubigeos',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer TU_TOKEN',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

Copiar

const response = await fetch('https://api.apiperu.dev/ubigeos', {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer TU_TOKEN',
  },
});

const data = await response.json();
console.log(data);

Copiar

import requests

response = requests.post(
    'https://api.apiperu.dev/ubigeos',
    headers={
        'Accept': 'application/json',
        'Authorization': 'Bearer TU_TOKEN',
    },
)

print(response.json())

Respuesta

200 OK application/json

{
  "success": true,
  "data": [
    {
      "codigo": "15",
      "nombre": "LIMA",
      "provincias": [
        {
          "codigo": "1501",
          "nombre": "LIMA",
          "distritos": [
            { "codigo": "150101", "nombre": "LIMA" },
            { "codigo": "150131", "nombre": "SAN ISIDRO" }
          ]
        }
      ]
    }
  ],
  "time": 0.2
}