---
title: "[BETA] List contacts"
method: GET
path: "/contacts"
tags: ["contacts"]
---

# [BETA] List contacts

`GET /contacts`

Retrieve a list of contacts with pagination.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Paginated list of contacts

- ContactsListResponse — Paginated list of contacts
  - `data` Contact[]
    - `id` string, uuid, required — Contact ID
    - `full_name` string — Full name
    - `first_name` string — First name
    - `last_name` string — Last name
    - `current_job_title` string — Current job title
    - `linkedin_url` string, uri — LinkedIn profile URL
    - `location` string — Location
    - `country` string, nullable — Country
    - `country_code` string, nullable — Country code
    - `summary` string — Professional summary
    - `image_url` string, uri — Profile image URL
    - `headline` string — Professional headline
    - `emails` string[] — Email addresses
    - `phones` string[] — Phone numbers
    - `skills` string[] — Skills
    - `company` object
      - `name` string
      - `linkedin_id` string
    - `experience` object[]
      - `job_id` string, uuid
      - `company_id` string, uuid
      - `company` string
      - `company_linkedin_id` string
      - `title` string
      - `location` string, nullable
      - `start_date` string, date-time
      - `end_date` string, date-time, nullable
      - `is_current` boolean
      - `description` string, nullable
      - `created_at` string, date-time
    - `education` object[]
      - `degree` string
      - `field_of_study` string, nullable
      - `school` string
      - `start_year` integer
      - `end_year` integer
    - `created_at` string, date-time — Creation timestamp
    - `updated_at` string, date-time, nullable — Last update timestamp
  - `pagination` object
    - `page` integer
    - `limit` integer
    - `total` integer

## Other responses

- `400` — Bad request
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Insufficient permissions. Required: contacts:read
- `404` — Not found
- `500` — Unexpected error

---

[API](https://skmtc.net/getpg/apis/pg-ai-public-api.md) · [All operations](https://skmtc.net/getpg/apis/pg-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getpg/pg-ai-public-api/versions/cc47d013c073/schema)