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

# Obter empresa

> Obtém os dados de uma empresa específica pelo CNPJ.



## OpenAPI

````yaml openapi.yaml GET /v1/company/{company-tax-id}
openapi: 3.1.0
info:
  title: Pipo Public API
  version: 0.2.0
  description: >
    API pública da Pipo Saúde para integração de movimentações de benefícios

    (inclusões, exclusões e consultas) por parceiros e sistemas de folha de
    pagamento.
  contact:
    name: Pipo Engineering
    email: felipe.rodopoulos@piposaude.com.br
servers:
  - url: https://api.pipo.health
    description: Homologação (staging)
  - url: https://api.piposaude.com.br
    description: Produção
security:
  - bearerAuth: []
tags:
  - name: Autenticação
    description: Obtenção do token de acesso.
  - name: Empresas
    description: Consulta de empresas e seus produtos.
  - name: Benefícios
    description: Consulta de produtos/benefícios disponíveis.
  - name: Movimentações
    description: Inclusões, exclusões e histórico de movimentações.
  - name: Membros
    description: Consulta de membros e seus benefícios.
  - name: Solicitações
    description: Consulta do status de requisições assíncronas.
  - name: Health Check
    description: Verificação de disponibilidade.
paths:
  /v1/company/{company-tax-id}:
    get:
      tags:
        - Empresas
      summary: Obter empresa
      description: Obtém os dados de uma empresa específica pelo CNPJ.
      parameters:
        - $ref: '#/components/parameters/CompanyTaxIdPath'
      responses:
        '200':
          description: Dados da empresa.
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/Company'
              example:
                result:
                  id: 123e4567-e89b-12d3-a456-426614174000
                  name: Acme Corporation
                  tax-id: '12345678000190'
                  products:
                    - product-id: 456e7890-e89b-12d3-a456-426614174001
                      product-name: Plano Saúde Premium
                      carrier-name: HealthCorp
                      product-type: health-insurance
                      allowed-dependent-types:
                        - child
                        - spouse
                      allowed-start-options:
                        - on-inclusion-date
                        - on-admission-date
                        - on-next-billing-period
        '403':
          $ref: '#/components/responses/NotEntitledCompany'
components:
  parameters:
    CompanyTaxIdPath:
      name: company-tax-id
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/Cnpj'
      description: CNPJ da empresa.
  schemas:
    Company:
      type: object
      required:
        - id
        - name
        - tax-id
        - products
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        tax-id:
          $ref: '#/components/schemas/Cnpj'
        products:
          type: array
          items:
            $ref: '#/components/schemas/CompanyProduct'
    Cnpj:
      type: string
      description: >-
        CNPJ (Cadastro Nacional da Pessoa Jurídica). Aceita apenas dígitos ou
        formatado.
      examples:
        - '12345678000190'
        - 12.345.678/0001-90
    CompanyProduct:
      type: object
      required:
        - product-id
        - product-name
        - carrier-name
        - product-type
      properties:
        product-id:
          type: string
          format: uuid
        product-name:
          type: string
        carrier-name:
          type: string
          description: Nome da operadora que fornece o produto.
        product-type:
          $ref: '#/components/schemas/ProductType'
        allowed-dependent-types:
          type: array
          items:
            $ref: '#/components/schemas/RelationshipType'
        allowed-start-options:
          type: array
          items:
            $ref: '#/components/schemas/StartOption'
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Mensagem descritiva do erro.
    ProductType:
      type: string
      description: Tipo de produto/benefício.
      enum:
        - health-insurance
        - dental-insurance
        - life-insurance
        - mental-health
        - gym
        - pet-insurance
        - private-pension
        - air-medical-transport
        - health-navigation
    RelationshipType:
      type: string
      description: Tipo de relação do dependente com o titular.
      enum:
        - adopted-child
        - child
        - companion
        - grandchild
        - grandparent
        - great-grandchild
        - niece-or-nephew
        - parent-in-law
        - parent
        - sibling
        - spouse
        - stepchild
        - uncle-or-aunt
        - unknown
        - ward
    StartOption:
      type: string
      description: >
        Opção de início do benefício.

        `on-inclusion-date`, `on-admission-date`, `on-next-billing-period`,
        `on-current-billing-period`(esta última quando `on-next-billing-period`
        está habilitada; ver Convenções).
      enum:
        - on-inclusion-date
        - on-admission-date
        - on-next-billing-period
        - on-current-billing-period
  responses:
    NotEntitledCompany:
      description: Não autorizado a acessar esta empresa.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Not entitled to access this company
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Token Bearer obtido em `POST /v1/authenticate`.

````