Contacts

List Contacts

Retrieve a paginated list of contacts across your organization.

integer

default:"1"

Page number for pagination.

integer

default:"25"

Number of contacts to return per page.

Permission: contacts:read

curl -X GET "https://api.getpg.ai/public-api/v1/contacts?page=1&limit=25" \
  -H "x-api-key: your_api_key"

{
  "data": [
    {
      "id": "deb3474b-5836-492c-aca4-4e0ccc8afbae",
      "full_name": "Iain Donachie",
      "first_name": "Iain",
      "last_name": "Donachie",
      "current_job_title": "Head of Gift Cards UK & Ireland, Tesco",
      "linkedin_url": "https://www.linkedin.com/in/iain-donachie-6bb3406",
      "location": "Edinburgh, Scotland, United Kingdom",
      "country": "United Kingdom"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 1
  }
}

Get Contact

Retrieve detailed information about a specific contact by ID, including work experience, education, and skills.

string

required

The unique identifier (UUID) of the contact.

Permission: contacts:read

curl -X GET "https://api.getpg.ai/public-api/v1/contacts/{contact_id}" \
  -H "x-api-key: your_api_key"

{
  "id": "deb3474b-5836-492c-aca4-4e0ccc8afbae",
  "full_name": "Iain Donachie",
  "first_name": "Iain",
  "last_name": "Donachie",
  "current_job_title": "Head of Gift Cards UK & Ireland, Tesco",
  "linkedin_url": "https://www.linkedin.com/in/iain-donachie-6bb3406",
  "location": "Edinburgh, Scotland, United Kingdom",
  "country": "United Kingdom",
  "headline": "Senior Product Leader with 18 years' experience driving strategic growth in Payments & Financial services.",
  "summary": "",
  "emails": [],
  "phones": [],
  "skills": [
    "Sales Planning",
    "P&L Management",
    "Banking",
    "Project Management",
    "Marketing Strategy"
  ],
  "company": {
    "name": "Gift Card & Voucher Association (GCVA)",
    "linkedin_id": "5010524"
  },
  "experience": [
    {
      "job_id": "9cc6abde-af26-4184-8f24-3caa4f96eb0a",
      "company_id": "304599c3-212f-4122-b84a-d655a1455d31",
      "company": "Tesco",
      "title": "Head of Gift Cards UK & Ireland, Tesco",
      "location": "Edinburgh, Scotland, United Kingdom",
      "start_date": "2025-02-01T00:00:00.000Z",
      "end_date": null,
      "is_current": true
    }
  ],
  "education": [
    {
      "degree": "BA Honours",
      "field_of_study": "Economics",
      "school": "University of Paisley",
      "start_year": 1993,
      "end_year": 1998
    }
  ],
  "created_at": "2026-04-01T12:47:07.324Z",
  "updated_at": null
}

{
  "error": {
    "type": "not_found",
    "code": "contact_not_found",
    "message": "Contact not found"
  }
}

Search Contacts

Beta — Search across all contacts in your workspace. Pass an empty body {} to return all contacts with pagination.

string

Filter contacts by name (partial match).

string

Filter contacts by job title.

string

Filter contacts by associated company UUID.

string

Filter contacts by location.

integer

default:"1"

Page number for pagination.

integer

default:"25"

Number of contacts per page.

Permission: contacts:read

curl -X POST "https://api.getpg.ai/public-api/v1/contacts/search" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "job_title": "Chief Revenue Officer",
    "per_page": 10
  }'

{
  "contacts": [
    {
      "id": "deb3474b-5836-492c-aca4-4e0ccc8afbae",
      "full_name": "Iain Donachie",
      "current_job_title": "Head of Gift Cards UK & Ireland, Tesco",
      "linkedin_url": "https://www.linkedin.com/in/iain-donachie-6bb3406",
      "location": "Edinburgh, Scotland, United Kingdom"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "total": 42,
    "total_pages": 5
  }
}

Enrich Contact

Beta — Queue an enrichment job to discover phone numbers and email addresses for a contact. Returns 202 Accepted immediately; poll GET /operations/{public_operation_id} for completion.

string

required

The unique identifier (UUID) of the contact to enrich.

Permission: contacts:write

Enrichment consumes credits. A 402 response means your organization has insufficient credits.

curl -X POST "https://api.getpg.ai/public-api/v1/contacts/{contact_id}/enrich/contact_info" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "public_operation_id": "op_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "accepted"
}

{
  "error": {
    "type": "payment_required",
    "code": "insufficient_credits",
    "message": "Your organization has insufficient credits to complete this enrichment."
  }
}

Overview

Endpoint Guides

MCP Server

List Contacts

Get Contact

Search Contacts

Enrich Contact

​List Contacts

​Get Contact

​Search Contacts

​Enrich Contact

List Contacts

Get Contact

Search Contacts

Enrich Contact