--- updatedAt: 2026-07-27T17:18:19.000Z agentTools: projectIndex: https://developer.demandbase.com/llms.txt --- # Fetch contact details Use this endpoint to fetch detailed employment and personal information for a specific contact. Retrieve data such as job titles, phone numbers, job levels, salary ranges, social profiles, and education history. You can control the response using query parameters to include specific fields or additional related data. # OpenAPI definition ````json { "openapi": "3.0.1", "info": { "version": "1.0", "title": "B2B API", "description": "The B2B API provides access to endpoints for searching, retrieving, and matching company and contact data.\n\nIt includes support for:\n- **Company records:** Firmographic details, news, technologies, and more.\n- **Contact records:** Current role, employment history, and professional details.\n- **Demandbase Person profiles:** Persistent identities tied to individuals across multiple roles or companies.\n- **Subscriptions:** Monitoring updates to companies and DB Person records.\n## Authentication\nAll requests to the B2B API must be authenticated using a valid API token. If authentication fails, the API will respond with a `401 Unauthorized` status code.\n### Obtaining an API Token\nFor instructions on generating API tokens, see the [Generate and Manage API Key Set](https://support.demandbase.com/hc/en-us/articles/38999526296603-Generate-and-Manage-API-Key-Set) article at the Demandbase Help Center.\n### Authorization Header\nInclude your API token in the `Authorization` header of each request using the Bearer token scheme. Also set the `Content-Type` header to `application/json` when sending JSON payloads.\n#### Example\n```\nAuthorization: Bearer YOUR_API_KEY_HERE\nContent-Type: application/json\n```\n\n> **Note:** Tokens should be treated as sensitive credentials. Do not expose them in public code repositories or client-side applications.", "contact": { "name": "Support", "url": "https://www.demandbase.com/", "email": "support@demandbase.com" } }, "servers": [ { "url": "https://uapi.demandbase.com/data/b2b/v1", "description": "Server URL in Production environment" } ], "paths": { "/contact/{contactId}": { "get": { "tags": [ "Sync API" ], "summary": "Fetch contact details", "description": "Use this endpoint to fetch detailed employment and personal information for a specific contact.\n\nRetrieve data such as job titles, phone numbers, job levels, salary ranges, social profiles, and education history.\n\nYou can control the response using query parameters to include specific fields or additional related data.", "operationId": "contactFetch", "parameters": [ { "name": "include", "in": "query", "description": "Additional data to include in the response, e.g., other employment", "required": false, "schema": { "type": "string", "enum": [ "other_employments" ], "example": "other_employments" } }, { "name": "contactId", "in": "path", "description": "Contact ID", "required": true, "schema": { "type": "string", "example": "725771" } }, { "name": "contactFields", "in": "query", "description": "Comma-separated contact fields to return.", "required": false, "schema": { "type": "string" } }, { "name": "peopleFields", "in": "query", "description": "Comma-separated person fields to return.", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Contact details fetched successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContactFetchResponseDTO" }, "examples": { "Success Response": { "description": "Success Response", "value": { "dbPersonDetails": { "firstName": "Darren", "lastName": "Jackson", "age": 68, "educationList": [ { "degree": "Masters of Business Administration", "university": "Wharton School of Business at the University of Pennsylvania" }, { "degree": "Bachelors", "university": "Indian Institute of Technology" }, { "degree": "Master of Science", "major": "Materials Science and Engineering", "university": "Stanford University" } ], "socialHandles": { "twitter": "http://twitter.com/andyhongim" }, "address": {}, "mobileNumber": "+1 425 707 0564" }, "employmentDetails": { "contactId": 215, "companyId": 734887, "companyName": "Advance Auto Parts, Inc.", "contactQualityScore": "A+", "description": "Mr. Darren R. Jackson is Chief Executive Officer, Director of Advance Auto Parts Inc. Since January 2008, Mr. Jackson has continuously served as our Chief Executive Officer. During that time period, Mr. Jackson also served as President from January 2008 to January 2009 and from January 1, 2012 to April 21, 2013, when George E. Sherman became our President. Prior to becoming our Chief Executive Officer, Mr. Jackson served in various executive positions with Best Buy Co., Inc., a specialty retailer of consumer electronics, office products, appliances and software, ultimately serving from July 2007 to December 2007 as Executive Vice President of Customer Operating Groups. He joined Best Buy in 2000 and was appointed as its Executive Vice President-Finance and Chief Financial Officer in February of 2001. Prior to 2000, he served as Vice President and Chief Financial Officer of Nordstrom, Inc., Full-line Stores, a fashion specialty retailer, and held various senior positions, including Chief Financial Officer of Carson Pirie Scott & Company, a regional department store company. He began his career at KPMG. Mr. Jackson has served as a director of Fastenal Company, which sells industrial and construction supplies, since July 2012. Mr. Jackson has served as a member of our Board for over ten years and as the Company's Chief Executive Officer for over seven years.", "startDate": "N/A", "salary": "930", "salaryCurrency": "USD", "phoneNumbers": { "directNumber": "+1 540 362 4911", "corporateNumber": "+1 425 882 8080" }, "emails": [ { "email": "djackson@advanceautoparts.com", "validationStatus": "VALID" } ], "lastValidatedDate": "Aug 15, 2019", "jobLevels": [ { "id": "1", "name": "C Level" }, { "id": "3", "name": "Vice President" } ], "jobFunctions": [ { "id": "22", "name": "Others" } ], "titles": [ "Chief Executive Officer and President" ] } } } } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ContactFetchResponseDTO" }, "examples": { "Success Response": { "description": "Success Response", "value": { "dbPersonDetails": { "firstName": "Darren", "lastName": "Jackson", "age": 68, "educationList": [ { "degree": "Masters of Business Administration", "university": "Wharton School of Business at the University of Pennsylvania" }, { "degree": "Bachelors", "university": "Indian Institute of Technology" }, { "degree": "Master of Science", "major": "Materials Science and Engineering", "university": "Stanford University" } ], "socialHandles": { "twitter": "http://twitter.com/andyhongim" }, "address": {}, "mobileNumber": "+1 425 707 0564" }, "employmentDetails": { "contactId": 215, "companyId": 734887, "companyName": "Advance Auto Parts, Inc.", "contactQualityScore": "A+", "description": "Mr. Darren R. Jackson is Chief Executive Officer, Director of Advance Auto Parts Inc. Since January 2008, Mr. Jackson has continuously served as our Chief Executive Officer. During that time period, Mr. Jackson also served as President from January 2008 to January 2009 and from January 1, 2012 to April 21, 2013, when George E. Sherman became our President. Prior to becoming our Chief Executive Officer, Mr. Jackson served in various executive positions with Best Buy Co., Inc., a specialty retailer of consumer electronics, office products, appliances and software, ultimately serving from July 2007 to December 2007 as Executive Vice President of Customer Operating Groups. He joined Best Buy in 2000 and was appointed as its Executive Vice President-Finance and Chief Financial Officer in February of 2001. Prior to 2000, he served as Vice President and Chief Financial Officer of Nordstrom, Inc., Full-line Stores, a fashion specialty retailer, and held various senior positions, including Chief Financial Officer of Carson Pirie Scott & Company, a regional department store company. He began his career at KPMG. Mr. Jackson has served as a director of Fastenal Company, which sells industrial and construction supplies, since July 2012. Mr. Jackson has served as a member of our Board for over ten years and as the Company's Chief Executive Officer for over seven years.", "startDate": "N/A", "salary": "930", "salaryCurrency": "USD", "phoneNumbers": { "directNumber": "+1 540 362 4911", "corporateNumber": "+1 425 882 8080" }, "emails": [ { "email": "djackson@advanceautoparts.com", "validationStatus": "VALID" } ], "lastValidatedDate": "Aug 15, 2019", "jobLevels": [ { "id": "1", "name": "C Level" }, { "id": "3", "name": "Vice President" } ], "jobFunctions": [ { "id": "22", "name": "Others" } ], "titles": [ "Chief Executive Officer and President" ] } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "InvalidContactIdResponse": { "description": "InvalidContactIdResponse", "value": { "errorCode": "400-104", "errorMessage": "ContactId must be an integer.", "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4" } }, "InvalidFieldResponse": { "description": "InvalidFieldResponse", "value": { "errorCode": "400-106", "errorMessage": "Invalid field name.", "diagnosticCode": "ab24b1a4-1cd0-41ab-bcfa-018f13fc6707" } } } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "InvalidContactIdResponseXml": { "description": "InvalidContactIdResponseXml", "value": { "errorCode": "400-104", "errorMessage": "ContactId must be an integer.", "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4" } }, "InvalidFieldResponseXml": { "description": "InvalidFieldResponseXml", "value": { "errorCode": "400-106", "errorMessage": "Invalid field name.", "diagnosticCode": "ab24b1a4-1cd0-41ab-bcfa-018f13fc6707" } } } } } }, "401": { "description": "Unauthorized because the user is not authenticated.", "content": { "application/json": { "examples": { "UnauthorizedResponse": { "description": "UnauthorizedResponse", "value": { "status": "Authentication Failed - Unauthorized." } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "ContactNotFoundErrorResponse": { "description": "ContactNotFoundErrorResponse", "value": { "errorCode": "404-100", "errorMessage": "Invalid ID, record not found.", "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4" } } } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "ContactNotFoundErrorResponseXml": { "description": "ContactNotFoundErrorResponseXml", "value": { "errorCode": "404-100", "errorMessage": "Invalid ID, record not found.", "diagnosticCode": "ccb84f25-236e-4bcf-be01-88b7dd673fb4" } } } } } } }, "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://uapi.demandbase.com/data/b2b/v1", "description": "Server URL in Production environment" } ] } } }, "tags": [ { "name": "Sync API", "description": "Synchronous company, contact, matching, news, and logo operations." } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "description": "[How To Generate Bearer Tokens](https://developer.demandbase.com/docs/auth-api)", "scheme": "bearer" } }, "schemas": { "ErrorResponse": { "type": "object", "properties": { "errorCode": { "type": "string" }, "errorMessage": { "type": "string" }, "diagnosticCode": { "type": "string" } }, "xml": { "name": "error" } }, "ContactFetchResponseDTO": { "type": "object", "properties": { "dbPersonDetails": { "$ref": "#/components/schemas/DBPersonDetails" }, "employmentDetails": { "$ref": "#/components/schemas/EmploymentDetails" }, "employmentHistoryList": { "type": "array", "items": { "$ref": "#/components/schemas/Employments" }, "xml": { "wrapped": true } } }, "xml": { "name": "contact" } }, "DBPersonDetails": { "type": "object", "properties": { "dbPersonId": { "type": "integer", "format": "int32" }, "firstName": { "type": "string" }, "middleName": { "type": "string" }, "lastName": { "type": "string" }, "age": { "type": "integer", "format": "int32" }, "mobileNumber": { "type": "string" }, "educationList": { "type": "array", "items": { "$ref": "#/components/schemas/Education" }, "xml": { "wrapped": true } }, "imageUrl": { "type": "string" }, "socialHandles": { "$ref": "#/components/schemas/SocialHandles" }, "address": { "$ref": "#/components/schemas/AddressDTO" } } }, "Education": { "type": "object", "properties": { "degree": { "type": "string" }, "major": { "type": "string" }, "university": { "type": "string" } } }, "SocialHandles": { "type": "object", "properties": { "twitter": { "type": "string" }, "facebook": { "type": "string" }, "linkedIn": { "type": "string" } } }, "AddressDTO": { "type": "object", "properties": { "street": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" }, "stateCode": { "type": "string" }, "zip": { "type": "string" }, "country": { "type": "string" }, "countryCode": { "type": "string" }, "latitude": { "type": "string" }, "longitude": { "type": "string" }, "area": { "type": "string" } } }, "EmploymentDetails": { "type": "object", "properties": { "contactId": { "type": "integer", "format": "int32" }, "companyId": { "type": "integer", "format": "int32" }, "companyName": { "type": "string" }, "contactQualityScore": { "type": "string" }, "description": { "type": "string" }, "startDate": { "type": "string" }, "salary": { "type": "string" }, "salaryCurrency": { "type": "string" }, "active": { "type": "string" }, "emails": { "type": "array", "items": { "$ref": "#/components/schemas/EmailDetails" }, "xml": { "wrapped": true } }, "lastValidatedDate": { "type": "string" }, "phoneNumbers": { "$ref": "#/components/schemas/PhoneNumbers" }, "jobLevels": { "type": "array", "items": { "$ref": "#/components/schemas/JobLevels" }, "xml": { "wrapped": true } }, "jobFunctions": { "type": "array", "items": { "$ref": "#/components/schemas/JobFunctions" }, "xml": { "wrapped": true } }, "titles": { "type": "array", "items": { "type": "string", "xml": { "name": "title" } }, "xml": { "wrapped": true } } } }, "EmailDetails": { "type": "object", "properties": { "email": { "type": "string" }, "validationStatus": { "type": "string" } } }, "PhoneNumbers": { "type": "object", "properties": { "directNumber": { "type": "string" }, "corporateNumber": { "type": "string" } } }, "JobLevels": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } } }, "JobFunctions": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } } }, "Employments": { "type": "object", "properties": { "contactId": { "type": "integer", "format": "int32" }, "companyId": { "type": "integer", "format": "int32" }, "companyName": { "type": "string" }, "emails": { "type": "array", "items": { "type": "string", "xml": { "name": "email" } }, "xml": { "wrapped": true } }, "phoneNumbers": { "$ref": "#/components/schemas/PhoneNumbers" }, "active": { "type": "string" }, "jobLevels": { "type": "array", "items": { "$ref": "#/components/schemas/JobLevels" }, "xml": { "wrapped": true } }, "jobFunctions": { "type": "array", "items": { "$ref": "#/components/schemas/JobFunctions" }, "xml": { "wrapped": true } }, "titles": { "type": "array", "items": { "type": "string", "xml": { "name": "title" } }, "xml": { "wrapped": true } } } } } }, "security": [ { "bearerAuth": [] } ] } ````