Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getpg.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
List Contacts

Retrieve a paginated list of contacts across your organization.
​
page
integer
default:"1"
Page number for pagination.
​
limit
integer
default:"50"
Number of contacts to return per page. Also accepts 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": "Invalid contact ID format"
}

{
  "error": "Contact not found"
}