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

# Listar contatos

`GET /v2/customers`

Listar contatos.

## Query parameters

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

## Response `200`

Lista de contatos

- Customer[]
  - `_id` string, hash
  - `address` Address
    - `city` unknown
    - `complement` unknown
    - `country` unknown
    - `district` unknown
    - `number` unknown
    - `state` unknown
    - `street` unknown
    - `zip_code` unknown
  - `cel_phone` string — Número de telefone do contato.
  - `email` unknown
  - `full_name` string — Nome completo do contato.
  - `job` JobInfo
    - `cnpj` unknown
    - `company` unknown
    - `department` unknown
    - `email` unknown
    - `occupation_area` unknown
    - `phone` unknown
    - `site` string, url — Website do negócio.
    - `title` unknown

## Other responses

- `401` — Access Token missing or invalid
- `403` — Not authorized to access such resource
- `500` — Internal Server Error

---

[API](https://skmtc.net/rdstation/apis/webhook-service.md) · [All operations](https://skmtc.net/rdstation/apis/webhook-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rdstation/webhook-service/revisions/3867c21388e8/schema)