Contact Data

Every contact the Signal API returns carries one consistent person profile. The same profile appears on contact enrich, contact search, and on any signal that is about a person.

This page lists every person field we hold, in two tables:

• Standard fields: returned by the API today.
• Available on request: phones, home address, demographics and more, added for you under a data agreement.

Coverage

Standard fields

These fields come back in every API response that includes the contact. No extra setup.

Fill is the share of the 17.1M signal-linked contacts that have a value (October 2026). When we have no value, the API leaves the key out. Treat a missing key as unknown.

Available on request

We can add any of these fields to your API responses, or deliver them as a monthly flat file to your GCS bucket, under a data agreement. Send the fields and record volume to [email protected]. We send back a sample with your own records matched.

Fill is the share of the source dataset that has a value (October 2026):

• US: our US person dataset (287M records).
• B2B: our US B2B person dataset (122M records).

Where the contact object appears

To check an email address in real time, use POST /v1/emails/verify (1 credit per email; unknown results are free).

Example

POST /v1/contacts/enrich with {"contact_linkedin_url": "https://www.linkedin.com/in/jane-doe-example"} returns:

{
  "contact": {
    "id": "5df7542a-0000-4000-8000-000000000001",
    "first_name": "Jane",
    "last_name": "Doe",
    "full_name": "Jane Doe",
    "headline": "VP Marketing at Example Corp",
    "linkedin_url": "https://www.linkedin.com/in/jane-doe-example",
    "job_title": "VP Marketing",
    "seniority": "VP",
    "department": "Marketing",
    "city": "Boston",
    "state": "MA",
    "country": "US",
    "current_job": {
      "company_name": "Example Corp",
      "company_domain": "example.com",
      "company_id": "3365d9b9-0000-4000-8000-000000000002",
      "title": "VP Marketing",
      "seniority": "VP",
      "department": "Marketing",
      "as_of": "2026-09-01"
    },
    "work_history": [
      {
        "company_name": "Example Corp",
        "company_domain": "example.com",
        "title": "VP Marketing",
        "start_date": "2023-04-01",
        "is_current": true
      },
      {
        "company_name": "Prior Co",
        "title": "Director of Demand Generation",
        "start_date": "2019-02-01",
        "end_date": "2023-04-01",
        "is_current": false
      }
    ],
    "education": [
      {
        "school": "Boston University",
        "degree": "Bachelor",
        "start_year": 2008,
        "end_year": 2012
      }
    ],
    "skills": [
      "Demand Generation",
      "B2B Marketing",
      "Marketing Automation"
    ],
    "emails": [
      {
        "address": "[email protected]",
        "type": "business",
        "status": "valid",
        "last_verified": "2026-09-30"
      }
    ]
  }
}

The full response also carries the company object (see Company Data) and the contact_signals array.

Values

Seniority (5): Staff, Manager, Director, VP, CXO. Filters accept common synonyms ("C-Suite", "Vice President", "Head of").

Department (18): Administrative, Community And Social Services, Education, Engineering, Executive, Finance, Government, Health Services, Human Resources, Information Technology, Legal, Marketing, Media And Communications, Military And Protective Services, Operations, Product Management, Real Estate, Sales.

GET /v1/filters returns the current lists for free.

Compliance

• Opted-out persons return no profile fields on any endpoint.
• Consumer attributes (home address, personal email, demographics) are US-only and licensed for marketing and identity-resolution use. They are not consumer reports and may not be used for credit, employment, insurance or tenant screening decisions (FCRA).
• Contact [email protected] for data-subject requests.

Migrating from the flat-file schema

Earlier versions of this page described a flat file keyed on up_id and cc_id. The API now keys every person on id and every company on company_id. The buyer-intent contact endpoints still return up_id for backward compatibility.