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

# List contacts

`GET /v2/teams/{teamKey}/contacts`

## Request

- Base URL: `https://api.streak.com/api`
- URL: `https://api.streak.com/api/v2/teams/{teamKey}/contacts`
- Auth: HTTP bearer

Lists contacts in stable order. Pass the returned cursor to continue; keep the same after filter across pages. A full last page may be followed by an empty page.

## Path parameters

- `teamKey` string, required

## Query parameters

- `after` integer: Epoch timestamp in seconds since 1970-01-01T00:00:00Z.
- `cursor` string
- `limit` integer

## Response `200`

OK

- ContactPage: A page of contact records and its continuation cursor.
  - `results` Contact[], required: Records in this page, in result order.
    - `key` string, required: Stable key for this contact.
    - `teamKey` string, required: Key for the team that owns this contact.
    - `givenName` string, nullable: Given name of the contact.
    - `familyName` string, nullable: Family name of the contact.
    - `other` string, nullable: Notes about the contact.
    - `title` string, nullable: Job title of the contact.
    - `emailAddresses` string[], required: Normalized email addresses with duplicates removed, in first-occurrence order.
    - `phoneNumbers` string[], required: Phone numbers with duplicates and null entries removed, in first-occurrence order.
    - `addresses` string[], required: Postal addresses with duplicates and null entries removed, in first-occurrence order.
    - `domains` string[], required: Website domains associated with the contact.
    - `normalizedDomains` string[], required: Stored normalized domains used to match organizations.
    - `twitterHandle` string, nullable: Twitter profile handle.
    - `facebookHandle` string, nullable: Facebook profile handle.
    - `linkedinHandle` string, nullable: LinkedIn profile handle.
    - `instagramHandle` string, nullable: Instagram profile handle.
    - `photoUrl` string, nullable: URL of the contact profile image.
    - `lastSavedUserKey` string, nullable: Key for the user who last edited this record.
    - `creatorKey` string, nullable: Key for the user who created this record.
    - `creationDate` integer, nullable: Time this record was first created, in epoch milliseconds.
    - `versionTimestamp` integer, nullable: Time this version of the record was created, in epoch milliseconds.
    - `lastSavedTimestamp` integer, nullable: Time this record was last saved, in epoch milliseconds.
    - `lastEnrichmentTimestamp` integer, nullable: Time enrichment was last applied or reviewed, in epoch milliseconds.
    - `contactLinks` ContactLink[], required: Contacts linked to this record, in their stored order.
      - `key` string, required: Key for the linked contact.
      - `isMagicLinked` boolean: Whether Streak linked this record automatically.
      - `creationTimestamp` integer, nullable: Time the relationship was created, in epoch milliseconds.
    - `orgLinks` OrganizationLink[], required: Organizations linked to this record, in their stored order.
      - `key` string, required: Stable key for the linked organization.
      - `isMagicLinked` boolean: Whether Streak linked this record automatically.
      - `creationTimestamp` integer, nullable: Time the relationship was created, in epoch milliseconds.
    - `fields` object, required: Custom field values keyed by field identifier.
  - `cursor` string, nullable: Opaque cursor to pass to the next page request, when present.

## Changes

- **2026-10-16** `1c3a5ef8b9ea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/streakyc/apis/streak/changes/v2/teams/:teamKey/contacts/get.md)

---

[API](https://skmtc.dev/streakyc/apis/streak.md) - [All operations](https://skmtc.dev/streakyc/apis/streak/llms.txt) - [OpenAPI document](https://skmtc.dev/streakyc/apis/streak/revisions/3648671fd1cf?raw)