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

# Obter contato por telefone

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

## Request

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

Obter contato por telefone. Os campos retornados em `data` estão definidos no schema da resposta.

## Path parameters

- `cel_phone` string, required

## Query parameters

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

## Response `200`

Contato encontrado

- object
  - `data` ContactByPhoneData: Campos retornados pelo endpoint Obter contato por telefone.
    - `_id` string, hash
    - `full_name` string
    - `cpf` string
    - `email` string, email
    - `cel_phone` string
    - `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.
    - `code` string
    - `tags` object[]
      - `name` string
    - `channel_metadata` object
    - `cnpj` string
    - `current_wallet` string
    - `customizable_field` ContactCustomizableField[]: Campos personalizados do contato. Array vazio quando não houver valores.
      - `info` string
      - `label` string
    - `last_message_data` object
      - `channel` string
      - `content` string
      - `created_at` string
      - `type` string
    - `employee` string, hash
  - `message` string: Mensagem de sucesso.

## Other responses

- `400`: Bad request
- `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)