---
title: "Convênio e parâmetros oficiais de um município"
method: GET
path: "/v1/municipios/{ibge}/parametros"
tags: ["Emissão de NFS-e"]
---

# Convênio e parâmetros oficiais de um município

`GET /v1/municipios/{ibge}/parametros`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/municipios/{ibge}/parametros`
- Auth: HTTP bearer

O que a Sudrel sabe do município a partir do Sistema Nacional:
se ele emite pelo Ambiente Nacional e os parâmetros oficiais já
consultados (alíquota do ISS por código de serviço, com vigência, e
retenções). Não dispara consulta nova: devolve o que está guardado,
com a data da consulta.

A chave de cada alíquota é o código de serviço da parametrização do
Sistema Nacional: código de tributação nacional com pontos mais os 3
dígitos do código de tributação municipal (ex.: `14.06.01.501`).

## Path parameters

- `ibge` string, required

## Response `200`

OK

- object
  - `municipio` object
    - `codigo_ibge` string
    - `nome` string
    - `uf` string
  - `convenio` object
    - `aderiu_ambiente_nacional` boolean
    - `fonte` 'api_oficial' | 'consulta_ao_vivo' | 'snapshot_local': De onde veio a informação do convênio.
    - `conferido_em` string, date-time, nullable
  - `parametros` object[]
    - `tipo` 'aliquota' | 'retencoes'
    - `chave` string
    - `tem_dados` boolean: `false`: o Sistema Nacional respondeu que não há parâmetro.
    - `dados` object
    - `vigencia_inicio` string, date-time, nullable
    - `vigencia_fim` string, date-time, nullable
    - `consultado_em` string, date-time

## Other responses

- `400`: Corpo ou parâmetros inválidos.
- `401`: Chave de API ausente, inválida ou revogada.
- `404`: Recurso não encontrado nesta conta.
- `429`: 120 requisições por minuto por chave excedidas (janela fixa de 60 s, alinhada ao relógio). Sem cabeçalho `Retry-After`: espere a virada do minuto. Nas rotas de conta, empresas e documentos o corpo é este; nas de emissão, lote, webhooks e eventos é problem+json `limite_de_requisicoes`.

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)