Saltar al contenido
Facturador

Ubigeos (departamentos, provincias y distritos)

GET /api/persons/locations

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Árbol de ubigeos del Perú para armar location_id ([departamento, provincia, distrito]). Cambia muy poco: guárdalo en caché.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

Formato de respuesta: heredado sin envoltura: devuelve directamente el objeto o arreglo (sin success). Devuelve {locations: [...]}.

Respuestas

200 — Ubigeos

{
  "locations": [
    {
      "value": "15",
      "label": "LIMA",
      "children": [
        {
          "value": "1501",
          "label": "LIMA",
          "children": [
            {
              "value": "150101",
              "label": "LIMA (150101)"
            },
            {
              "value": "150122",
              "label": "MIRAFLORES (150122)"
            }
          ]
        }
      ]
    }
  ]
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.