---
title: "List team contacts"
method: GET
path: "/teams/{team_id}/contacts"
tags: ["Contacts"]
---

# List team contacts

`GET /teams/{team_id}/contacts`

List the contacts of a team (workspace).

Required scope: `contacts:read`

## Path parameters

- `team_id` string, required

## Query parameters

- `q` string
- `limit` integer
- `page_token` string
- `sort_by` string
- `sort_order` 'asc' | 'desc'

## 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.net/frontapp/apis/core-api.md) · [All operations](https://skmtc.net/frontapp/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/frontapp/core-api/revisions/76d1eaa2d0eb/schema)