---
title: "Get contacts by channel"
method: GET
path: "/orgs/analytics/contacts/by-channel"
tags: ["Analytics and logs"]
---

# Get contacts by channel

`GET /orgs/analytics/contacts/by-channel`

## Request

- Base URL: `https://api.useinvent.com`
- URL: `https://api.useinvent.com/orgs/analytics/contacts/by-channel`
- Auth: HTTP bearer

Get contact count per channel type.

## Query parameters

- `from_date` string, date-time, nullable: Start of the range (ISO 8601 date). Omit for all time.
- `to_date` string, date-time, nullable: End of the range (ISO 8601 date). Omit for up to now.
- `page` number
- `take` number
- `next` string
- `progressive` boolean

## Response `200`

- ContactsByChannelItemSchema[]
  - `type` 'internal' | 'org' | 'agent' | 'custom' | 'whatsapp_bot' | 'messenger_bot' | 'instagram_dm' | 'tiktok_dm' | 'telegram_bot' | 'slack_bot' | 'teams_bot' | 'gmail' | 'outlook' | 'twilio' | 'telnyx' | 'email' | 'smpp', required: The channel type
  - `count` number, required

---

[API](https://skmtc.dev/useinvent/apis/invent-api.md) · [All operations](https://skmtc.dev/useinvent/apis/invent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useinvent/apis/invent-api/revisions/98824f3fde82?raw)