Retorna uno o más listados de municipios.

POST

/municipios

const url = 'https://apis.datos.gob.ar/georef/api/municipios';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"municipios":[{"id":"example","nombre":"example","provincia":"Santa Fe","interseccion":"provincia:82,departamento:82084,municipio:820196","orden":"id","aplanar":true,"campos":"estandar","max":10,"inicio":10,"exacto":true}]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://apis.datos.gob.ar/georef/api/municipios \
  --header 'Content-Type: application/json' \
  --data '{ "municipios": [ { "id": "example", "nombre": "example", "provincia": "Santa Fe", "interseccion": "provincia:82,departamento:82084,municipio:820196", "orden": "id", "aplanar": true, "campos": "estandar", "max": 10, "inicio": 10, "exacto": true } ] }'

Permite realizar varias búsquedas sobre el listado de municipios en simultáneo.

Request Body

Consultas en formato JSON.

application/json

object

municipios

required

Array<object>

>= 1 items

object

string

>= 1 characters

nombre

string

>= 1 characters

provincia

string

>= 1 characters

Example

Santa Fe

interseccion

string

Example

provincia:82,departamento:82084,municipio:820196

orden

string

Allowed values: id nombre

aplanar

Example

true

campos

string

>= 1 characters

Example

estandar

max

integer

>= 1 <= 5000

Example

inicio

integer

>= 1 <= 5000

Example

exacto

Example

true

Responses

200

Listados de municipios.

application/json

object

resultados

Array<object>

object

cantidad

integer

total

integer

inicio

integer

parametros

object

municipios

Array<object>

object

string

nombre

string

nombre_completo

string

provincia

object

string

nombre

string

centroide

object

lat

number

lon

number

categoria

string

Example

{
  "resultados": [
    {
      "cantidad": 10,
      "total": 1820,
      "inicio": 0,
      "parametros": {},
      "municipios": [
        {
          "id": "820196",
          "nombre": "Granadero Baigorria",
          "nombre_completo": "Municipio Granadero Baigorria",
          "provincia": {
            "id": "82",
            "nombre": "Santa Fe"
          },
          "centroide": {
            "lat": -32.851319,
            "lon": -60.704006
          },
          "categoria": "Municipio"
        }
      ]
    }
  ]
}

400

Error al procesar las consultas.

application/json

object

errores

Array<Array<object>>

Example

{
  "errores": [
    [
      {
        "codigo_interno": 1000,
        "mensaje": "El parámetro especificado no existe.",
        "nombre_parametro": "prueba",
        "ubicacion": "querystring"
      }
    ]
  ]
}