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

# Obter Empresa

> Retorna os detalhes de uma empresa específica a partir do seu ID.

### Path

<ParamField path="id" type="string" required>
  UUID da empresa.
</ParamField>

### Response

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "e4b6d4e8-8e6d-41da-abdb-8fc358a9e7f1",
    "tenantId": "e305e9a4-585e-49b8-bc88-9fba992c6326",
    "name": "Acme Corp",
    "document": "12345678000199",
    "status": "ACTIVE",
    "email": "contact@acme.com",
    "address": null,
    "settings": {},
    "taxRegime": "SIMPLES_NACIONAL",
    "costMethod": "WEIGHTED_AVERAGE",
    "createdAt": "2024-01-01T12:00:00.000Z",
    "updatedAt": "2024-01-01T12:00:00.000Z"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml get /companies/{id}
openapi: 3.0.0
info:
  title: Hub Marketplace API
  description: API for managing marketplace listings and keys
  version: '1.0'
  contact: {}
servers: []
security: []
tags:
  - name: listings
    description: ''
paths:
  /companies/{id}:
    get:
      tags:
        - Companies
      summary: Get a specific company by ID
      operationId: CompaniesController_findOne
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: Return the company.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Company'
        '404':
          description: Company not found.
      security:
        - bearer: []
components:
  schemas:
    Company:
      type: object
      properties:
        name:
          type: string
          description: Company Name
          example: Acme Corp
        document:
          type: string
          description: CNPJ or CPF
          example: '12345678000199'
        status:
          type: string
          enum:
            - ACTIVE
            - DISABLED
            - BLOCKED
            - SUSPENDED
          example: ACTIVE
          description: Company Status
        email:
          type: string
          description: Contact Email
          example: contact@acme.com
        address:
          type: object
          description: Address Object
        settings:
          type: object
          description: Configuration Settings
          example: {}
        taxRegime:
          type: string
          enum:
            - SIMPLES_NACIONAL
            - LUCRO_PRESUMIDO
            - LUCRO_REAL
          example: SIMPLES_NACIONAL
          description: Tax Regime
        costMethod:
          type: string
          enum:
            - REPLACEMENT
            - WEIGHTED_AVERAGE
          example: WEIGHTED_AVERAGE
          description: Cost Method
      required:
        - name
        - document
        - status
        - settings
        - taxRegime
        - costMethod

````