Retorna un listado de municipios.

GET

/municipios

const url = 'https://apis.datos.gob.ar/georef/api/municipios?provincia=Santa%20Fe&interseccion=provincia%3A82%2Cdepartamento%3A82084%2Cmunicipio%3A820196&orden=id&aplanar=true&campos=estandar&max=10&inicio=0&exacto=true&formato=json';
const options = {method: 'GET'};

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

curl --request GET \
  --url 'https://apis.datos.gob.ar/georef/api/municipios?provincia=Santa%20Fe&interseccion=provincia%3A82%2Cdepartamento%3A82084%2Cmunicipio%3A820196&orden=id&aplanar=true&campos=estandar&max=10&inicio=0&exacto=true&formato=json'

Permite realizar búsquedas sobre el listado de municipios.

Parameters

Query Parameters

string

>= 1 characters

Filtrar por ID. Se pueden especificar varios IDs separados por comas.

nombre

string

>= 1 characters

Filtrar por nombre.

provincia

string

>= 1 characters

Example

Santa Fe

Filtrar por nombre o ID de provincia. Se pueden especificar varios IDs separados por comas.

interseccion

string

Example

provincia:82,departamento:82084,municipio:820196

Filtrar por intersección con otras entidades geográficas. El valor del campo debe tener el siguiente formato:

< tipo de entidad A>:<id 1>:<id 2>, < tipo de entidad B>:<id 1>:<id 2>, …

Se incluye en la respuesta cualquier entidad que intereseccione con una o más de las entidades con los IDs especificados.

orden

string

Allowed values: id nombre

Campo por el cual ordenar los resultados.

aplanar

Example

true

Cuando está presente, muestra el resultado JSON con una estructura plana.

campos

string

>= 1 characters

Example

estandar

Campos a incluir en la respuesta separados por comas, sin espacios. Algunos campos siempre serán incluidos, incluso si no se agregaron en la lista. Para incluir campos de sub-entidades, separar los nombres con un punto, por ejemplo: provincia.id. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer

>= 1 <= 5000

Example

Cantidad máxima de resultados a devolver.

inicio

integer

<= 10000

Example

Cantidad de resultados a saltear.

exacto

Example

true

Cuando está presente, se activa el modo de búsqueda por texto exacto. Sólo tiene efecto cuando se usan campos de búsqueda por texto (por ejemplo, nombre).

formato

string

Allowed values: json csv geojson xml

Formato de datos en el cual devolver los resultados.

Responses

200

Listado de municipios.

application/json

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

{
  "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 la consulta.

application/json

object

errores

Array<object>

object

codigo_interno

integer

mensaje

string

nombre_parametro

string

ubicacion

string

Example

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