GET
/
lists
/
{id}
curl --request GET \
  --url https://api.pipeium.com/lists/123e4567-e89b-12d3-a456-426614174000 \
  --header 'Authorization: Bearer {api_key}'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Enterprise Prospects",
  "webhookUrl": "https://api.yourapp.com/webhooks/pipeium",
  "enrichments": [
    {
      "id": "enr_123",
      "type": "email",
      "status": "COMPLETED",
      "verifyEmail": true,
      "completeMissingData": true
    }
  ],

  "contacts": [
    {
      "id": "con_123",
      "firstName": "John",
      "lastName": "Smith",
      "email": "john@acme.com",
      "phoneNumber": "+1234567890",
      "linkedin": "https://linkedin.com/in/johnsmith",
      "jobTitle": "Sales Director",
      "qualified": true
    }
  ],
  "accounts": [
    {
      "id": "acc_123",
      "name": "Acme Inc",
      "domain": "acme.com",
      "linkedin": "https://linkedin.com/company/acme",
      "qualified": true
    }
  ]
}
Retrieve detailed information about a list, including all contacts, accounts, signals, enrichments, and custom columns.

Path Parameters

id
string
required
The ID of the list to retrieve

Response

id
string
List ID
name
string
List name
webhookUrl
string
Webhook URL for notifications
enrichments
array
Array of enrichment jobs
contacts
array
Array of contacts in the list
accounts
array
Array of accounts in the list
curl --request GET \
  --url https://api.pipeium.com/lists/123e4567-e89b-12d3-a456-426614174000 \
  --header 'Authorization: Bearer {api_key}'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Enterprise Prospects",
  "webhookUrl": "https://api.yourapp.com/webhooks/pipeium",
  "enrichments": [
    {
      "id": "enr_123",
      "type": "email",
      "status": "COMPLETED",
      "verifyEmail": true,
      "completeMissingData": true
    }
  ],

  "contacts": [
    {
      "id": "con_123",
      "firstName": "John",
      "lastName": "Smith",
      "email": "john@acme.com",
      "phoneNumber": "+1234567890",
      "linkedin": "https://linkedin.com/in/johnsmith",
      "jobTitle": "Sales Director",
      "qualified": true
    }
  ],
  "accounts": [
    {
      "id": "acc_123",
      "name": "Acme Inc",
      "domain": "acme.com",
      "linkedin": "https://linkedin.com/company/acme",
      "qualified": true
    }
  ]
}