---
title: "Listar contatos"
method: GET
path: "/v2/customers"
tags: ["conversas-v2-contacts"]
---

# Listar contatos

`GET /v2/customers`

## Request

- Base URL: `https://api.tallos.com.br`
- URL: `https://api.tallos.com.br/v2/customers`
- Auth: HTTP bearer

Listar contatos.

## Query parameters

- `limit` integer
- `page` integer
- `channels` 'telegram' | 'whatsapp'

## Response `200`

Lista de contatos

- Customer[]
  - `_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.
  - `cel_phone` string: Número de telefone do contato.
  - `email` string, nullable: Endereço de e-mail do contato.
  - `full_name` string: Nome completo do contato.
  - `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.
  - `customizable_field` ContactCustomizableField[]: Campos personalizados do contato. Array vazio quando não houver valores.
    - `info` string
    - `label` string

## Other responses

- `401`: Access Token missing or invalid
- `403`: Not authorized to access such resource
- `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)