---
title: "List Contacts"
method: GET
path: "/companies/{companyId}/contacts"
tags: ["Contacts"]
---

# List Contacts

`GET /companies/{companyId}/contacts`

## Request

- Base URL: `https://api.pax8.com/v1`
- URL: `https://api.pax8.com/v1/companies/{companyId}/contacts`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://token-manager.pax8.com/oauth/token`

Returns a paginated list of contacts ordered by ```createDate``` descending

## Path parameters

- `companyId` string, uuid, required

## Query parameters

- `page` number
- `size` number

## Response `200`

Successful operation

- object
  - `content` Contact[]
    - `id` string, uuid: The id
    - `firstName` string, required: The first name
    - `lastName` string, required: The last name
    - `email` string, email, required: The email
    - `phone` string, phone, required: The phone number
    - `createdDate` string: The created date
    - `types` ContactType[]
      - `type` 'Admin' | 'Billing' | 'Technical': A company must have a primary contact for each contact type. A single contact can be marked as a primary contact for all types Contact Type: * `Admin` - Administrative contact * `Billing` - Billing contact * `Technical` - Technical contact
      - `primary` boolean: Is this contact the primary contact for this Contact Type
  - `page` Page
    - `size` number: The size of the page
    - `totalElements` unknown
    - `totalPages` unknown
    - `number` unknown

## Other responses

- `404`: Company not found

---

[API](https://skmtc.dev/pax8/apis/partner-endpoints.md) - [All operations](https://skmtc.dev/pax8/apis/partner-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/pax8/apis/partner-endpoints/revisions/f90cec5b4720?raw)