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

# Tabela de códigos

> Retorna tabelas de tradução de códigos usados nos dados de empresas. Use o parâmetro tipo para filtrar uma tabela específica.



## OpenAPI

````yaml /openapi/empresas.json get /empresas/codigos
openapi: 3.0.0
info:
  title: Sherlocker Empresas API
  description: >-
    Perfil completo de empresas: dados cadastrais, quadro societario,
    funcionarios, dividas, veiculos, imoveis, processos, aeronaves, patentes,
    trabalhista, rural, beneficios fiscais e compliance. Ponto de entrada para
    investigacoes empresariais.
  version: '2.0'
servers:
  - url: https://221b-api.sherlocker.com.br/api/v1
security:
  - tokenAuth: []
paths:
  /empresas/codigos:
    get:
      tags:
        - Empresas
      summary: Tabela de códigos
      description: >-
        Retorna tabelas de tradução de códigos usados nos dados de empresas. Use
        o parâmetro tipo para filtrar uma tabela específica.
      operationId: getCodigos
      parameters:
        - name: tipo
          in: query
          required: false
          description: >-
            Filtrar por tipo: naturezas, cnaes, qualificacoes, motivos, paises.
            Se omitido, retorna todas.
          schema:
            type: string
            example: naturezas
      responses:
        '200':
          description: Tabelas de códigos
          content:
            application/json:
              schema:
                type: object
                properties:
                  tipo:
                    type: string
                    description: Tipo da tabela filtrada
                  total:
                    type: integer
                    description: Total de registros
                  dados:
                    type: array
                    items:
                      type: object
                      properties:
                        codigo:
                          type: string
                          description: Código identificador
                        descricao:
                          type: string
                          description: Descrição do código
              example:
                tipo: naturezas
                total: 90
                dados:
                  - codigo: '2011'
                    descricao: Empresa Pública
                  - codigo: '2038'
                    descricao: Sociedade de Economia Mista
                  - codigo: '2046'
                    descricao: Sociedade Anônima Aberta
                  - codigo: '2054'
                    descricao: Sociedade Anônima Fechada
                  - codigo: '2062'
                    descricao: Sociedade Empresária Limitada
                  - codigo: '2135'
                    descricao: Empresário (Individual)
        '400':
          description: Parametro invalido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Token ausente ou invalido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        erro:
          type: object
          properties:
            codigo:
              type: string
              description: 'Codigo do erro (ex: VALIDATION_ERROR, NOT_FOUND, UNAUTHORIZED)'
              example: VALIDATION_ERROR
            mensagem:
              type: string
              description: Mensagem descritiva do erro
              example: CPF invalido
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: query
      name: token

````