Synchronous company, contact, matching, news, and logo operations.
Make your first request
Use this guide to move from authentication to a valid Sync API request, then open each endpoint guide for the full request and response details.
Get an access token
Use the authentication flow for your workspace and send the token as a Bearer credential.
Read the response
Check the status, content type, and documented response fields before processing results.
HTTP the documented path
Endpoint guides explain URL parameters, headers, request bodies, and required values.
Endpoint guides pair a response example with the generated technical schema so implementation and validation stay together.
Sync API
Search, match, and enrich companies and contacts with synchronous B2B API operations. Start with a feature guide, then open its child page for the generated endpoint request and response specification.
Getting started
Use the synchronous API when your application needs an immediate search, match, or enrichment response. Authenticate each request with a Demandbase bearer token, send the required identifiers or filters, and handle the response before continuing the workflow.
Choose a feature
Start with search, match, company, or contact enrichment based on the data your workflow already has.
Open the endpoint spec
Each feature card below leads to a top-level guide. Its child page contains the exact generated request parameters, schemas, examples, and responses.
Plan for limits
Use pagination, stable Demandbase IDs, rate-limit handling, and the credit model when moving from testing to production.
Sync endpoints
These feature guides are the first level of the two-level B2B reference. They explain when to use an operation; the linked child page is the actual endpoint technical specification.
Search contacts
Find professionals at target accounts using person, employment, company, and contactability attributes.
View endpoint tech specs →Search companies
Find target accounts using firmographic, geographic, industry, technology, and intent-related filters.
View endpoint tech specs →Fetch company details
Retrieve a detailed company record when you already have a Demandbase company ID.
View endpoint tech specs →Fetch company news by category
Retrieve categorized news for a company using the supported news category reference IDs.
View endpoint tech specs →Fetch company news feed
Retrieve the company news feed for recent account-level activity and updates.
View endpoint tech specs →Fetch company logo
Retrieve an available company logo in the requested size for use in account experiences.
View endpoint tech specs →Fetch contact details
Retrieve detailed person and employment information for a known contact ID.
View endpoint tech specs →Match companies and contacts
Resolve submitted company or contact attributes to Demandbase IDs for downstream enrichment.
View endpoint tech specs →Batch workflows
For larger matching and enrichment workloads, use the asynchronous batch API. It creates a job, lets you poll job status, and returns results without holding a synchronous request open.
Common conventions
Bearer authentication
Send the bearer token in the Authorization header for every request. Keep credentials server-side and rotate them according to your organization’s security practices.
Demandbase identifiers
Prefer Demandbase company and contact IDs after matching. Stable IDs make subsequent enrichment and update requests more predictable.
Errors and pagination
Treat non-success responses as actionable API errors, preserve request context for troubleshooting, and follow endpoint-specific pagination fields where they are provided.
Review the rate limits, credit consumption model, and B2B best practices before enabling production traffic.