---
title: "Obter contato por CPF"
method: GET
path: "/v2/contacts/cpf/{cpf}/exists"
tags: ["conversas-v2-contacts"]
---

# Obter contato por CPF

`GET /v2/contacts/cpf/{cpf}/exists`

## Request

- Base URL: `https://api.tallos.com.br`
- URL: `https://api.tallos.com.br/v2/contacts/cpf/{cpf}/exists`
- Auth: HTTP bearer

Obter contato por CPF.

## Path parameters

- `cpf` string, required

## Query parameters

- `channel` 'email' | 'instagram' | 'megasac' | 'messenger' | 'telegram' | 'whatsapp'

## Response `200`

Contato encontrado

- object
  - `data` Contact
    - `_id` string, hash
    - `address` Address
      - `city` string, nullable: Cidade do endereço.
      - `complement` string, nullable: Informações complementares para o endereço.
      - `country` string, nullable: País do endereço.
      - `district` string, nullable: Bairro/Distrito do endereço.
      - `number` string, nullable: Número do endereço.
      - `state` string, nullable: Estado/Província do endereço.
      - `street` string, nullable: Rua do endereço.
      - `zip_code` string, nullable: Código Postal do endereço.
    - `birth_date` string: Data de nascimento no formato brasileiro (DD/MM/YYYY).
    - `cel_phone` string: Número de telefone do contato.
    - `channel_metadata` object: Integração do WhatsApp a qual o contato está atribuído atualmente.
    - `cnpj` string, nullable: Número de CNPJ do contato.
    - `code` string: Código do contato.
    - `cpf` string, nullable: Número de CPF do contato.
    - `current_wallet` string: Nome da carteira ao qual o contato será inserido.
    - `customizable_field` ContactCustomizableField[], nullable: Campos personalizados do contato. Array vazio quando não houver valores.
      - `info` string
      - `label` string
    - `department_name` string: Nome do setor que o contato será direcionado.
    - `description` string: Descrição.
    - `email` string, email: Endereço de e-mail do contato.
    - `employee` string, hash
    - `full_name` string: Nome completo do contato.
    - `integration` string: Integração do WhatsApp a qual o contato está criado.
    - `job` JobInfo
      - `cnpj` string, nullable: CNPJ ou outro identificador único do negócio.
      - `company` string, nullable: Companhia de contato.
      - `department` string, nullable: Departamento correspondente.
      - `email` string, email, nullable: Endereço de e-mail para contato.
      - `occupation_area` string, nullable: Área de ocupação.
      - `phone` string, nullable: Telefone para contato.
      - `site` string, url: Website do negócio.
      - `title` string, nullable: Título do trabalho.
    - `last_message_data` object: Última mensagem enviada pelo contato.
      - `channel` 'email' | 'instagram' | 'megasac' | 'messenger' | 'telegram' | 'whatsapp'
      - `content` string: Conteúdo da mensagem.
      - `created_at` string: Data e hora que o contato enviou a mensagem.
      - `type` string: Tipo da mensagem.
    - `rg` string, nullable: Número de RG do contato.
    - `tags` string[]: Tags.
    - `workflow_stage_title` string: Título do Estágio do Workflow ao qual o contato será atribuído.
    - `workflow_title` string: Título do Workflow ao qual o contato será atribuído.
  - `message` string: Mensagem de sucesso.

## Other responses

- `401`: Access Token missing or invalid
- `403`: Not authorized to access such resource
- `404`: Resource not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/revisions/730a895096d0?raw)