---
title: "Get contacts for the account"
method: GET
path: "/v2/contacts"
tags: ["contacts-v2"]
---

# Get contacts for the account

`GET /v2/contacts`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/contacts`
- Auth: API key in header `X-Api-Key`

Filter by list_number and/or active status.

## Query parameters

- `per_page` string
- `page` string
- `active` string
- `list_number` string

## Response `200`

Success

- ContactsListResponse
  - `contacts` ContactListItem[]: Array of contacts
    - `active` boolean: Subscription status
    - `carrier` string: Carrier name
    - `click_count` integer: Total clicks
    - `conversion_count` integer: Total conversions
    - `custom_fields` object: Custom fields
    - `in_workflow` boolean: In active workflow
    - `is_valid` boolean: Phone validity
    - `last_clicked_at` string, date-time: Last click
    - `last_sent_at` string, date-time: Last message sent
    - `line_type` string: Line type
    - `list_id` integer: Sending list ID
    - `list_number` string: Sending list phone number
    - `phone_number` string: Contact phone number (E.164)
    - `revenue_total` number: Total revenue
    - `send_count` integer: Total sends
    - `signup_date` string, date-time: Signup date
    - `signup_method` string: How contact signed up
    - `timezone` string: Timezone
  - `pagination` Pagination
    - `page` integer: Current page
    - `per_page` integer: Items per page
    - `total` integer: Total items
    - `total_pages` integer: Total pages

## Other responses

- `401`: Authentication error

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)