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

# Buscar contatos

> Busca contatos com base no nome de uma empresa.



## OpenAPI

````yaml enrichments-openapi post /enrichments/contacts
openapi: 3.1.0
info:
  title: Searching API
  version: 0.1.0
servers:
  - url: https://exact.ws
security:
  - Bearer: []
paths:
  /enrichments/contacts:
    post:
      summary: Buscar contatos
      description: Busca contatos com base no nome de uma empresa.
      operationId: EnrichmentsContactsFindContacts
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FindContactsInput'
        required: true
      responses:
        '200':
          description: Request fulfilled, document follows
          headers: {}
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/CompletedWorkflow_FindContactsOutput_'
                  - $ref: '#/components/schemas/RunningWorkflow'
                  - $ref: '#/components/schemas/FailedWorkflow'
        '400':
          description: Bad request syntax or unsupported method
          content:
            application/json:
              schema:
                properties:
                  status_code:
                    type: integer
                  detail:
                    type: string
                  extra:
                    additionalProperties: {}
                    type:
                      - 'null'
                      - object
                      - array
                type: object
                required:
                  - detail
                  - status_code
                description: Validation Exception
                examples:
                  - status_code: 400
                    detail: Bad Request
                    extra: {}
      deprecated: false
components:
  schemas:
    FindContactsInput:
      properties:
        webhook_url:
          oneOf:
            - type: string
            - type: 'null'
        company_name:
          type: string
          description: Nome da empresa
        company_id:
          oneOf:
            - type: string
            - type: 'null'
          description: CNPJ da empresa
        contact_name:
          oneOf:
            - type: string
            - type: 'null'
          description: Nome do contato
        keywords:
          items:
            type: string
          type: array
          description: Palavras-chave para pesquisa (posição, setor e afins)
          default: []
      type: object
      required:
        - company_name
      title: FindContactsInput
    CompletedWorkflow_FindContactsOutput_:
      properties:
        id:
          type: string
        status:
          type: string
          const: COMPLETED
          description: Situação do workflow (completo)
          default: COMPLETED
        data:
          $ref: '#/components/schemas/FindContactsOutput'
      type: object
      required:
        - data
        - id
      title: CompletedWorkflow[FindContactsOutput]
    RunningWorkflow:
      properties:
        id:
          type: string
        status:
          type: string
          const: RUNNING
          description: Situação do workflow (em execução)
          default: RUNNING
      type: object
      required:
        - id
      title: RunningWorkflow
    FailedWorkflow:
      properties:
        id:
          type: string
        status:
          type: string
          const: FAILED
          description: Situação do workflow (falha)
          default: FAILED
      type: object
      required:
        - id
      title: FailedWorkflow
    FindContactsOutput:
      properties:
        contacts:
          items:
            $ref: '#/components/schemas/Contact'
          type: array
          description: Lista de contatos encontrados
          default: []
      type: object
      required: []
      title: FindContactsOutput
      description: Resultado da execução do workflow
    Contact:
      properties:
        last_updated_at:
          oneOf:
            - type: string
              format: date-time
            - type: 'null'
          description: >-
            A data/hora em que estes dados foram obtidos, no formato
            especificado pela RFC 3339 (e.g. `2017-07-21T17:32:28Z`)
        name:
          type: string
          description: Nome do contato
        position:
          oneOf:
            - type: string
            - type: 'null'
          description: Posição na empresa
        profiles:
          items:
            $ref: '#/components/schemas/Profile'
          type: array
          description: Perfis em redes sociais
          default: []
      type: object
      required:
        - name
      title: Contact
    Profile:
      properties:
        platform:
          $ref: '#/components/schemas/Platform'
        url:
          type: string
          description: Link para o perfil
      type: object
      required:
        - platform
        - url
      title: Profile
    Platform:
      type: string
      enum:
        - FACEBOOK
        - INSTAGRAM
        - GITHUB
        - LINKEDIN
        - X
        - YOUTUBE
      title: Platform
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer

````