Skip to main content

​
List Contacts

Retrieve a paginated list of contacts across your organization.
​
page
integer
default:"1"
Page number for pagination.
​
limit
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.
​
contact_id
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.
​
name
string
Filter contacts by name (partial match).
​
job_title
string
Filter contacts by job title.
​
company_id
string
Filter contacts by associated company UUID.
​
location
string
Filter contacts by location.
​
page
integer
default:"1"
Page number for pagination.
​
per_page
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.
​
contact_id
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."
  }
}