v3

latestOpenAPI 3.1.1mit2026-07-3165481.5 MB
Contacts
v1

Get Contact Details

Get the details of a contact by ID. Credit Note: Accessing full deep data consumes 1 credit, unless the contact was already accessed within the last 12 months.

:::info Requires the contacts:read OAuth2 scope. :::

get/v1/contacts/{id}

Path parameters

idstring required

The contact's ID. Note that the older string-based ID format continues to be supported.

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

include'company' | 'lists' | 'buyer_personas' | 'crm_connections' | 'crm_connections.crm_record' | 'crm_connections.crm_record.crm_owner' | 'crm_suggestions' | 'crm_suggestions.crm_record' | 'crm_suggestions.crm_record.crm_owner'

Specify which additional data should be attached to the result.

Response

Returns the contact details for the specified ID. If include=company is supplied, the response includes the company details. If no contact is found for the specified ID, a 404 error is raised.

Example response

{
  "data": {
    "type": "contact",
    "id": "435834",
    "attributes": {
      "address": {
        "city": "Karlsruhe",
        "country_code": "DE",
        "country": "Germany",
        "region": "Baden-Württemberg",
        "region_code": "DE1"
      },
      "affiliation": "employee",
      "departments": [
        "marketing_department",
        "students_apprentices"
      ],
      "emails": [
        {
          "address": "info@leadfeeder.com",
          "source": "fullenrich"
        }
      ],
      "first_name": "John",
      "gender": "male",
      "hierarchy_level": "employees",
      "last_name": "Doe",
      "phones": [
        {
          "number": "+49 721 50057501",
          "type": "landline",
          "source": "fullenrich"
        }
      ],
      "position": {
        "title": "Geschäftsführer",
        "language_code": "DE"
      },
      "public_sources": [
        {
          "type": "homepage",
          "url": "https://crowdfunding.dossier.at/unterstuetzerinnen/"
        }
      ],
      "social_media_profiles": {
        "facebook": [
          {
            "url": "https://www.facebook.com/getdealfront",
            "source": "fullenrich"
          }
        ],
        "instagram": [
          {
            "url": "https://instagram.com/getdealfront",
            "source": null
          }
        ],
        "linkedin": [
          {
            "url": "https://www.linkedin.com/company/dealfront",
            "source": "fullenrich"
          }
        ],
        "pinterest": [],
        "twitter": [
          {
            "url": "https://twitter.com/getdealfront",
            "source": null
          }
        ],
        "xing": [],
        "youtube": []
      },
      "title": "Dr."
    },
    "relationships": {
      "company": {
        "id": "129011"
      },
      "lists": [
        {
          "type": "list",
          "id": "company_123",
          "attributes": {
            "name": "US Prospects",
            "scope": "company",
            "created_at": "2024-12-10T15:57:25Z",
            "updated_at": "2024-11-24T11:50:00Z"
          },
          "relationships": {
            "created_by": {
              "id": "12345"
            }
          }
        }
      ],
      "buyer_personas": [
        {
          "type": "buyer_persona",
          "id": "7421",
          "attributes": {
            "name": "Sales Managers",
            "created_at": "2024-12-10T15:57:25Z",
            "filters": {
              "department": [
                {
                  "search_value": "US",
                  "display_value": "United States"
                }
              ],
              "job_title": [
                {
                  "search_value": "US",
                  "display_value": "United States"
                }
              ],
              "location": [
                {
                  "search_value": "US",
                  "display_value": "United States"
                }
              ],
              "seniority": [
                {
                  "search_value": "US",
                  "display_value": "United States"
                }
              ]
            }
          }
        }
      ]
    }
  },
  "meta": {
    "credits": {
      "charged": 1
    },
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}