--- updatedAt: 2026-06-03T12:16:05.000Z agentTools: projectIndex: https://docs.asaas.com/llms.txt --- # List municipal configurations Endpoint used to query which tax information the municipality requires for invoice issuance. This request should be the first step of the fiscal integration, since not all municipalities require the same data. The response informs which fields must later be filled in the endpoint for creating or updating fiscal information. The query considers the city registered in the account's CNPJ. ## Returned information The response may include the following fields: * `authenticationType` - Indicates which authentication method is required by the municipality for invoice issuance. Possible values are: * `CERTIFICATE` - The municipality requires a digital certificate. * `TOKEN` - The municipality requires an access token. * `USER_AND_PASSWORD` - The municipality requires username and password. * `supportsCancellation` - Indicates whether the municipality allows automatic invoice cancellation through integration. * `usesSpecialTaxRegimes` - Indicates whether the municipality requires a special tax regime to be sent. When this field is `true`, the value must be sent in the `specialTaxRegime` attribute when creating or updating fiscal information. * `usesServiceListItem` - Indicates whether the municipality requires the service list item. When this field is `true`, the value must be sent in `serviceListItem`. * `specialTaxRegimesList` - List of special tax regimes accepted by the municipality. Each item usually contains: * `label` - Display name of the regime. * `value` - Identifier that must be sent to the API. * `municipalInscriptionHelp` - Support text with guidance on the expected format for the municipal registration. * `specialTaxRegimeHelp` - Support text about filling in the special tax regime. * `serviceListItemHelp` - Support text about the service list item. * `digitalCertificatedHelp` - Support text about the digital certificate. * `accessTokenHelp` - Support text about the token required by the municipality. * `municipalServiceCodeHelp` - Support text about the format of the municipal service code. > 🚧 **Attention** > > Each municipality has its own rules for invoice issuance. > > * Some municipalities require authentication through a digital certificate, while others use token or username and password. > * Fields such as `specialTaxRegime` and `serviceListItem` may be mandatory depending on the returned configuration. > * It is always recommended to query this endpoint before configuring or updating the account's fiscal information. ## Importance of the query This endpoint is important because it prevents configuration attempts using incorrect, invalid, or unnecessary fields. Using this query beforehand reduces failures in the fiscal issuance process and ensures that the integration sends only the information required by the corresponding municipality. # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Asaas", "description": "API pública de integração com a plataforma Asaas.", "version": "3.0.0" }, "servers": [ { "url": "https://api-sandbox.asaas.com", "description": "Sandbox" } ], "security": [ { "Authorization": [] } ], "tags": [ { "name": "Fiscal Info" } ], "paths": { "/v3/fiscalInfo/municipalOptions": { "get": { "tags": [ "Fiscal Info" ], "summary": "List municipal configurations", "description": "", "operationId": "list-municipal-configurations", "responses": { "200": { "description": "Ok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FiscalInfoMunicipalOptionsGetResponseDTO" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponseDTO" }, "example": { "errors": [ { "code": "error_code", "description": "Error description" } ] } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponseDTO" }, "example": { "errors": [ { "code": "invalid_access_token", "description": "A chave de API fornecida é inválida" } ] } } } }, "403": { "description": "Forbidden. Occurs when the request body is filled, GET method calls must have an empty body." } }, "deprecated": false } } }, "components": { "schemas": { "ErrorResponseDTO": { "type": "object", "properties": { "errors": { "type": "array", "description": "List of objects", "deprecated": false, "items": { "$ref": "#/components/schemas/ErrorResponseItemDTO" } } } }, "ErrorResponseItemDTO": { "type": "object", "properties": { "code": { "type": "string", "description": "Error code", "deprecated": false, "example": null }, "description": { "type": "string", "description": "Error description", "deprecated": false, "example": null } }, "description": "List of objects", "deprecated": false }, "FiscalInfoMunicipalOptionsGetResponseDTO": { "type": "object", "properties": { "authenticationType": { "$ref": "#/components/schemas/FiscalInfoMunicipalOptionsGetResponseEnotasTipoAutenticacao" }, "supportsCancellation": { "type": "boolean", "description": "Whether or not it supports the cancellation of invoices automatically at your city hall", "example": true, "deprecated": false, "default": true }, "usesSpecialTaxRegimes": { "type": "boolean", "description": "It is necessary to inform or not the special taxation regime. If used, enter it in the `specialTaxRegime` field of **Create or update tax information** according to the options returned in the `specialTaxRegimesList` list.", "example": true, "deprecated": false, "default": true }, "usesServiceListItem": { "type": "boolean", "description": "Whether or not to inform the item on the service list", "example": true, "deprecated": false, "default": true }, "specialTaxRegimesList": { "type": "array", "description": "Tax calculation regime options", "deprecated": false, "items": { "$ref": "#/components/schemas/FiscalInfoMunicipalOptionsSpecialTaxRegimesDTO" } }, "nationalPortalTaxCalculationRegimeList": { "type": "array", "description": "Special taxation regime options", "deprecated": false, "items": { "$ref": "#/components/schemas/FiscalInfoMunicipalOptionsNationalPortalTaxCalculationRegimeDTO" } }, "nationalPortalTaxCalculationRegimeHelp": { "type": "string", "description": "Explanation of the tax calculation regime", "example": "This identifies your company's tax calculation regime. If you wish to leave no option selected, select the \"None\" option. It must only be completed by companies classified as ME or EPP opting for Simples Nacional. Consult the need for this information with your city hall or accounting department.", "deprecated": false }, "municipalInscriptionHelp": { "type": "string", "description": "Explanation of the municipal registration format", "example": "Only enter numbers without periods or formatting (if they contain letters, always enter them in capital letters).\r\n\r\nValid examples: 4301000010 or 131436001X", "deprecated": false }, "specialTaxRegimeHelp": { "type": "string", "description": "Explanation of the special taxation regime", "example": "This identifies your company's taxation regime, if you wish to leave no option marked, select the dash (\"-\").\r\n \r\n Simple national companies generally opt for ME or ME EPP", "deprecated": false }, "serviceListItemHelp": { "type": "string", "description": "Explanation of service list item format", "example": "Enter the service list item here, it is also an identifier of the service provided.\r\n \r\n You need to complete the service list item maintaining the formatting.\r\n Valid examples: 17.02 or 8.02", "deprecated": false }, "digitalCertificatedHelp": { "type": "string", "description": "Explanation of digital certificate", "example": "Your city hall requires the use of a digital certificate, so include your A1 certificate file here.", "deprecated": false }, "accessTokenHelp": { "type": "string", "description": "Token Explanation", "deprecated": false, "example": null }, "municipalServiceCodeHelp": { "type": "string", "description": "Explanation of municipal service code format", "example": "Enter here the municipal code that identifies the service provided on the invoice.\r\nIn some cities this code is known as the taxation code or CTISS.\r\n\r\nValid example: 010300388", "deprecated": false } } }, "FiscalInfoMunicipalOptionsGetResponseEnotasTipoAutenticacao": { "type": "string", "description": "Type of authentication required at city hall", "example": "CERTIFICATE", "deprecated": false, "enum": [ "CERTIFICATE", "TOKEN", "USER_AND_PASSWORD" ] }, "FiscalInfoMunicipalOptionsSpecialTaxRegimesDTO": { "type": "object", "properties": { "label": { "type": "string", "description": "Name of the special taxation regime", "example": "Municipal Micro enterprise", "deprecated": false }, "value": { "type": "string", "description": "Special taxation regime identifier", "example": "1", "deprecated": false } }, "description": "Tax calculation regime options", "deprecated": false }, "FiscalInfoMunicipalOptionsNationalPortalTaxCalculationRegimeDTO": { "type": "object", "properties": { "label": { "type": "string", "description": "Name of the tax calculation regime", "example": "Regime for calculating federal and municipal taxes by the SN", "deprecated": false }, "value": { "type": "string", "description": "Identifier of the tax calculation regime", "example": "0", "deprecated": false } }, "description": "Special taxation regime options", "deprecated": false } }, "securitySchemes": { "Authorization": { "type": "apiKey", "name": "access_token", "in": "header" } } }, "x-readme": { "headers": [ { "key": "User-Agent", "value": "NomeDaSuaAplicacao/1.0.0" } ] } } ``` # Sibling pages * [Create and update tax information](https://docs.asaas.com/reference/create-and-update-tax-information.md) * [Retrieve tax information](https://docs.asaas.com/reference/retrieve-tax-information.md) * [List municipal services](https://docs.asaas.com/reference/list-municipal-services.md) * [List NBS codes](https://docs.asaas.com/reference/list-nbs-codes.md) * [Configure invoice issuing portal](https://docs.asaas.com/reference/configure-invoice-issuing-portal.md) * [List federal service codes](https://docs.asaas.com/reference/list-federal-service-codes.md) * [List operation indicator codes](https://docs.asaas.com/reference/list-operation-indicator-codes.md) * [List tax classification codes](https://docs.asaas.com/reference/list-tax-classification-codes.md) * [List tax situation codes](https://docs.asaas.com/reference/list-tax-situation-codes.md)