Contacts

Get Contact Details

Changed on Oct 22, 2026

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}

Request

Base URL
https://api.leadfeeder.com
URL
https://api.leadfeeder.com/v1/contacts/{id}
Auth
- API key in header X-Api-Key
- or OAuth 2
  Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
  Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: contacts:read

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.

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": {
    "attributes": {
      "address": {
        "city": "Karlsruhe",
        "country": "Germany",
        "country_code": "DE",
        "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",
          "source": "fullenrich",
          "type": "landline"
        }
      ],
      "position": {
        "language_code": "DE",
        "title": "Geschäftsführer"
      },
      "public_sources": [
        {
          "type": "homepage",
          "url": "https://crowdfunding.dossier.at/unterstuetzerinnen/"
        }
      ],
      "social_media_profiles": {
        "facebook": [
          {
            "source": "fullenrich",
            "url": "https://www.facebook.com/getdealfront"
          }
        ],
        "instagram": [
          {
            "source": null,
            "url": "https://instagram.com/getdealfront"
          }
        ],
        "linkedin": [
          {
            "source": "fullenrich",
            "url": "https://www.linkedin.com/company/dealfront"
          }
        ],
        "pinterest": [],
        "twitter": [
          {
            "source": null,
            "url": "https://twitter.com/getdealfront"
          }
        ],
        "xing": [],
        "youtube": []
      },
      "title": "Dr."
    },
    "id": "435834",
    "relationships": {
      "buyer_personas": [
        {
          "attributes": {
            "created_at": "2024-12-10T15:57:25Z",
            "filters": {
              "department": [
                {
                  "display_value": "United States",
                  "search_value": "US"
                }
              ],
              "job_title": [
                {
                  "display_value": "United States",
                  "search_value": "US"
                }
              ],
              "location": [
                {
                  "display_value": "United States",
                  "search_value": "US",
                  "type": "country_code"
                }
              ],
              "seniority": [
                {
                  "display_value": "United States",
                  "search_value": "US"
                }
              ]
            },
            "name": "Sales Managers"
          },
          "id": "7421",
          "type": "buyer_persona"
        }
      ],
      "company": {
        "id": "129011"
      },
      "lists": [
        {
          "attributes": {
            "created_at": "2024-12-10T15:57:25Z",
            "name": "US Prospects",
            "scope": "company",
            "updated_at": "2024-11-24T11:50:00Z"
          },
          "id": "company_123",
          "relationships": {
            "created_by": {
              "id": "12345"
            }
          },
          "type": "list"
        }
      ]
    },
    "type": "contact"
  },
  "meta": {
    "credits": {
      "charged": 1
    },
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

Oct 22, 2026ff9df8ba8977 Revision changes
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ///////////////////////////// to the response with the status
- info
  added the optional property ///////////////////////////// to the response with the status
- info
  added the optional property ///////////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ///////////////////////////// to the response with the status
- info
  added the optional property ///////////////////////////// to the response with the status
- info
  added the optional property ///////////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ///////////////////////////// to the response with the status
- info
  added the optional property ///////////////////////////// to the response with the status
- info
  added the optional property ///////////////////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_code deprecated
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_code deprecated
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_code deprecated
- info
  response property data/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated
Sep 24, 20261a2c2b1d560f Revision changes
- breaking
  the response property /////////// became nullable for the status
- breaking
  the response property /////////// became nullable for the status
- breaking
  the response property /////////// became nullable for the status

Operation history (10 revisions)