---
title: "List contacts in group"
method: GET
path: "/contact_groups/{contact_group_id}/contacts"
tags: ["Contact Groups"]
deprecated: true
---

# List contacts in group

`GET /contact_groups/{contact_group_id}/contacts`

> **Deprecated.**

List the contacts belonging to the requested group.

> ⚠️ Deprecated endpoint
>
> This endpoint has been deprecated. Please use the compatible contact list endpoints instead.
> - `GET /contact_lists/{contact_list_id}/contacts`.


Required scope: `contacts:read`

## Path parameters

- `contact_group_id` string, required

## Query parameters

- `page_token` string
- `limit` integer

## Response `200`

Array of contacts

- object
  - `_pagination` object
    - `next` string, nullable — Link to next [page of results](https://dev.frontapp.com/docs/pagination)
  - `_links` object
    - `self` string — Link to resource
  - `_results` ContactResponse[]
    - `_links` object
      - `self` string — Link to resource
      - `related` object
        - `notes` string — Link to contact notes
        - `conversations` string — Link to contact conversations
        - `owner` string — Link to contact owner
    - `id` string — Unique identifier of the contact
    - `name` string — Contact name
    - `description` string — Contact description
    - `avatar_url` string — URL of the contact's avatar
    - `links` string[] — List of all the links of the contact
    - `groups` ContactListResponses[] — List of the groups the contact belongs to. ⚠️ Deprecated. use `lists` instead.
      - `_links` object
        - `self` string — Link to resource
        - `related` object
          - `contacts` string — Link to contact list contacts
          - `owner` string — Link to list owner
      - `id` string — Unique identifier of the list
      - `name` string — Name of the list
      - `is_private` boolean — Whether or not the contact is individual
    - `lists` ContactListResponses[] — List of the contact lists the contact belongs to.
      - `_links` object
        - `self` string — Link to resource
        - `related` object
          - `contacts` string — Link to contact list contacts
          - `owner` string — Link to list owner
      - `id` string — Unique identifier of the list
      - `name` string — Name of the list
      - `is_private` boolean — Whether or not the contact is individual
    - `handles` ContactHandle[] — List of the handles and sources with which the contact is reachable.
      - `handle` string, required — Handle used to reach the contact.
      - `source` 'twitter' | 'email' | 'phone' | 'facebook' | 'intercom' | 'front_chat' | 'custom', required — Source of the handle. Can be `email`, `phone`, `twitter`, `facebook`, `intercom`, `front_chat`, or `custom`.
    - `custom_fields` CustomFieldParameter — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
    - `is_private` boolean — Whether or not the contact is individual

---

[API](https://skmtc.dev/frontapp/apis/core-api.md) · [All operations](https://skmtc.dev/frontapp/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/frontapp/core-api/revisions/76d1eaa2d0eb/schema)
