Retrieve Contacts
Retrieve a list of contacts based on the provided IDs. Credit Note: Each contact will contain its full deep data and it will consume 1 credit, unless the contact has already been accessed within the last 12 months.
:::info Requires the contacts:read OAuth2 scope. :::
Query parameters
Comma separated list of contact IDs. A maximum of 100 IDs can be passed to this endpoint. Note that the older string-based ID format continues to be supported.
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 IDs. If include=company is supplied, the responses include the company details. If no contact is found for a certain ID, the data field will not contain an entry for that ID.
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"
}
}