> ## Documentation Index
> Fetch the complete documentation index at: https://developers.portao3.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# List a city's special tax regimes

> Lists the special taxation regimes a city hall supports for service invoice (NFSe) issuance.

Send the 7-digit IBGE code of the city as `specialTaxCode`. Use the `id` of the regime that applies to your organization as `specialTaxCode` when you create your tax issuer. A city with no special regimes answers an empty list.

The regimes come from the tax provider. If the tax provider rejects the request, the error is returned with the provider's error `code` and a status of 400, 409, 422 or 502.


## OpenAPI

````yaml /api-reference/accounting.openapi.json get /taxCode/{specialTaxCode}
openapi: 3.0.3
info:
  title: Accounting
  version: 1.0.0
  description: >-
    Portão 3 accounting API. Every endpoint requires a bearer token in the
    Authorization header (Authorization: Bearer <token>) unless its page states
    otherwise; see the Authentication guide. That requirement is not repeated
    per endpoint. Generated by tools/openapi from code (routes + security) and
    the hand-written spec (request/response bodies). NFSe issuance: the
    organization's tax issuer (setup, certificate, logo), its tax documents
    (issue, list, download, cancel, CSV batches) and the city special-tax-regime
    lookup. Every route validates path, query, body and multipart form through a
    zod Input class (`accounting/app/use-case/*/inputs`), which documents it;
    responses are the named interfaces in
    `accounting/app/use-case/*/outputs/*Response.ts`. Confidence tiers:
    generated:typed=24 copied:manual=0 unknown=0.
servers:
  - url: https://api.accounting.v2.portao3.com.br/
    description: production
  - url: https://api.accounting.dev.3pers.com.br/
    description: development
security: []
tags:
  - name: Tax Issuers
  - name: Tax Documents (NFSe)
  - name: Tax Codes
paths:
  /taxCode/{specialTaxCode}:
    get:
      tags:
        - Tax Codes
      summary: List a city's special tax regimes
      description: >-
        Lists the special taxation regimes a city hall supports for service
        invoice (NFSe) issuance.
      operationId: getTaxCodeBySpecialTaxCode
      parameters:
        - name: specialTaxCode
          in: path
          required: true
          description: >-
            IBGE code of the city (7 digits). The path parameter keeps its
            historical name.
          schema:
            type: string
            pattern: ^\d{7}$
          example: '3170206'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: >-
                        Code of the special taxation regime — send it as
                        `specialTaxCode` when you create your tax issuer.
                      example: '1'
                    name:
                      type: string
                      description: Name of the regime, as the city hall calls it.
                      example: Microempresa municipal
                  required:
                    - id
                    - name
                  description: >-
                    A special taxation regime the city hall supports for service
                    invoice (NFSe) issuance.
        '422':
          description: >-
            `BAD_REQUEST` — `specialTaxCode` is not a 7-digit IBGE code;
            `fields` lists it.
          content:
            application/json:
              schema:
                type: object
                properties:
                  traceId:
                    type: string
                    description: >-
                      Identifier of the request that failed. Quote it when
                      contacting support.
                    example: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                  code:
                    type: string
                    enum:
                      - BAD_REQUEST
                    description: >-
                      Stable, machine-readable error code. Branch on this, never
                      on `message`.
                  origin:
                    type: string
                    enum:
                      - ACCOUNTING
                    description: Service that produced the error.
                  message:
                    type: string
                    description: >-
                      Human-readable explanation. Its wording may change without
                      notice.
                  fields:
                    type: array
                    description: >-
                      One entry per invalid request field (validation errors
                      only).
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          description: >-
                            Path of the invalid field, e.g. `label` or
                            `values[0].value`.
                          example: label
                        message:
                          type: string
                          description: Why the field was rejected.
                          example: label is required
                        code:
                          type: string
                          description: >-
                            `<FIELD>_<REASON>` — e.g. `LABEL_REQUIRED`,
                            `TYPE_ONE_OF`, `VALUES_VALUE_TYPE_ERROR`.
                          example: LABEL_REQUIRED
                        values:
                          type: array
                          items:
                            type: string
                          description: >-
                            The accepted values, when the field is an
                            enumeration.
                      required:
                        - field
                        - message
                        - code
                required:
                  - traceId
                  - code
                  - origin
                  - message
              example:
                traceId: 1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b
                code: BAD_REQUEST
                origin: ACCOUNTING
                message: >-
                  Bad Request: Your request is invalid or incomplete. Please
                  make sure you are requesting with the right fields.
                fields:
                  - field: id
                    message: 'Invalid input: expected string, received undefined'
                    code: ID_REQUIRED

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.