How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Demandbase

Demandbase B2B API

Company and contact intelligence: search and fetch companies and contacts, company news, logos, installed technologies and corporate hierarchy; synchronous and bulk matching; asynchronous bulk data retrieval; and change subscriptions with webhook alerts for company, company-news, family-tree and person records. 22 operations.

Documentation Provider Profile APIs.io OpenAPI GitHub

This API exposes 22 operations across 20 paths, organized into 4 resource areas, and defines 72 schemas. It is described by OpenAPI 3.0.1, at version 1.0.

Requests are made against a single base URL, https://uapi.demandbase.com/data/b2b/v1.

22 operations 20 paths 72 schemas 1 DELETE14 GET6 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0
Base URL
https://uapi.demandbase.com/data/b2b/v1
Authentication
HTTP Bearer
Contact
Support
Resource Areas
4

Authentication & Security 1

Demandbase B2B API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — [ How To Generate Bearer Tokens ](https://developer.demandbase.com/reference/generateaccesstoken)

Paths & Operations 22

Across 20 paths, the API surfaces 22 operations — 1 DELETE, 14 GET, 6 POST, 1 PUT. They span 4 resource areas: Sync API, Asynchronous (Batch) API, Subscription API, Reference Tables. Each is listed below with its method, path, parameters, and response codes.

Sync API 8

Synchronous company, contact, matching, news, and logo operations.

POST
/contacts
Search contacts
contactSearch_1 body → 200400401
POST
/companies
Search companies
companySearch_1 body → 200400401
GET
/contact/{contactId}
Fetch contact details
contactFetch 4 params → 200400401404
GET
/company/{companyId}
Fetch company details
companyFetch 4 params → 200400401404
GET
/company/{companyId}/news
Fetch company news by category
companyNewsCategoryFetch 4 params → 200400401404
GET
/company/{companyId}/newsFeed
Fetch company news feed
companyNewsFetch 3 params → 200400401404
GET
/company/{companyId}/logos/{logoSize}
Fetch company logo
companyLogoFetch 2 params → 200400401
POST
/match
Match companies and contact
match_1 body → 200400401
Asynchronous (Batch) API 3

Asynchronous bulk jobs for high-volume data retrieval and matching.

GET
/job/{jobId}
Get Bulk Job Status
getBulkJobStatus 1 param → 200400401404500
POST
/match/job
Match Companies and Contacts in Bulk
match 1 param body → 202400401
POST
/job
Create a Bulk Data Retrieval Job
createBulkJob body → 202400401
Subscription API 10

Subscription creation, updates, status, alerts, and lifecycle operations.

PUT
/subscriptions/job
Update an Existing Subscription
updateSubscription body → 202400401
POST
/subscriptions/job
Create a New Subscription
updateSubscription_1 body → 202400401
GET
/subscriptions/{subscriptionId}/entityIds
Get Subscription Entity IDs
getSubscriptionEntityDetails 3 params → 200401404
GET
/subscriptions/{subscriptionId}/alerts/{alertId}
Retrieve a Specific Subscription Alert
getSubscriptionAlertDetails 4 params → 200401404
GET
/subscriptions/{subscriptionId}/alerts
List Subscription Alerts
getSubscriptionAlertsList 3 params → 200401404
GET
/subscriptions/{subscriptionId}
Retrieve Subscription Details
getSubscriptionDetails 1 param → 200400401404
DELETE
/subscriptions/{subscriptionId}
Delete a Subscription
deleteSubscription 1 param → 200401404
GET
/subscriptions/jobs
List Subscription Jobs
subscriptionJobsListFetch 7 params → 200400401
GET
/subscriptions/job/{jobId}
Check Subscription Job Status
getSubscriptionJobStatus 1 param → 200400401404
GET
/subscriptions
List Subscriptions
getAllSubscriptionsByClientID 3 params → 200400
Reference Tables 1

Reference schemas and allowed values used by the B2B API.

GET
/reference/{object}
Get reference data for an object
getReferenceData 1 param → 200400401403

Schemas 72

The contract defines 72 schemas that model the data the API accepts and returns. The most detailed are CompanySearchRequestDTO (40 properties), CompanyFetchResponseDTO (36 properties), ContactSearchRequestDTO (31 properties), MatchRequest (20 properties). Each schema is shown below with its type and property counts.

ContactSearchRequestDTO
object
31 properties
ContactSearchResponseDTO
object
4 properties
ContactResultsDTO
object
2 properties
PersonDTO
object
5 properties
EmploymentDTO
object
10 properties
JobLevelsV2
object
2 properties
JobFunctionsV2
object
2 properties
ErrorResponse
object
3 properties
UnauthorizedResponse
object
1 property
CompanySearchRequestDTO
object
40 properties
CompanySearchResponseDTO
object
4 properties
CompanyDTO
object
5 properties
ContactFetchResponseDTO
object
3 properties
DBPersonDetails
object
10 properties
Education
object
3 properties
SocialHandles
object
3 properties
AddressDTO
object
10 properties
CompanyAddressDTO
object
Company address. State and country are returned as codes when available.
8 properties
EmploymentDetails
object
15 properties
EmailDetails
object
2 properties
PhoneNumbers
object
2 properties
JobLevels
object
2 properties
JobFunctions
object
2 properties
Employments
object
9 properties
CompanyFetchResponseDTO
object
36 properties
TickerDTO
object
2 properties
ClassificationDTO
object
2 properties
BusinessDTO
object
4 properties
BritishSicDTO
object
2 properties
SocialHandlesDTO
object
4 properties
DiversityDTO
object
3 properties
DiversityCertificationsDTO
object
6 properties
FamilyTreeResultDTO
object
2 properties
AcquiredCompanyResultDTO
object
1 property
CompanyTechUsedDTO
object
Installed technology information grouped by category and subcategory.
1 property
TechUsedCategoryDTO
object
A technology category and its subcategories.
3 properties
TechUsedSubCategoryDTO
object
A technology subcategory and its detected products.
3 properties
TechUsedProductDTO
object
A product detected for the company.
2 properties
CompanyNewsResponseDTO
object
5 properties
CompanyNewsArticle
object
6 properties
MatchRequestDTO
object
5 properties 1 required
MatchRequest
object
20 properties 1 required
MatchResponseDTO
object
1 property
MatchResponse
object
3 properties
CompanyMatchDTO
object
1 property
ContactMatchDTO
object
1 property
BulkJobStatusDTO
object
8 properties
JobRequestDTO
object
6 properties 4 required
JobFilter
object
2 properties 2 required
UpdateSubscriptionJobRequestDTO
object
15 properties
SubscriptionJobResponseDTO
object
7 properties
CreateSubscriptionJobRequestDTO
object
11 properties
SubscriptionEntityDetailsDTO
object
6 properties
GetAlertDefinitionDTO
object
9 properties
CompanyAlertData
object
3 properties
CompanyNewsAlertData
object
4 properties
ContactAlertData
object
4 properties
EmploymentAlertData
object
3 properties
FamilyTreeAlertData
object
4 properties
FamilyTreeChangeEventDTO
object
6 properties
FieldDTO
object
3 properties
SubscriptionDetailsResponse
object
10 properties
WebhookDTO
object
Webhook configuration object containing target URL, signing secret, and validation error(if any).
4 properties
GetAlertsResponseDTO
object
5 properties
AlertResponseDTO
object
2 properties
SubscriptionDeleteResponse
object
2 properties
SubscriptionJobsListResponseDTO
object
5 properties
SubscriptionJobsListDTO
object
5 properties
BulkSubscriptionJobStatusResponseDTO
object
8 properties
SubscriptionListResponse
object
5 properties
SubscriptionDetailsDTO
object
5 properties
ReferenceDataResponseDTO
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

demandbase-b2b-openapi.yml Raw ↑
← Back to D APIs
API Details
ID
demandbase:demandbase-b2b-api
Base URL
https://uapi.demandbase.com/data/b2b/v1
Docs
https://developer.demandbase.com/docs/b2b-overview
Provider
Demandbase
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=demandbase-demandbase-b2b-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/demandbase-demandbase-b2b-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Demandbase B2B API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.