# Demandbase Documentation > Documentation for Demandbase ## Guides: documentation - [Developer Hub](https://developer.demandbase.com/docs/welcome.md) - Demandbase APIs - [Demandbase API Overview](https://developer.demandbase.com/docs/demandbase-api-overview.md) - [Understanding Demandbase API Access and Licensing](https://developer.demandbase.com/docs/understanding-demandbase-api-access-and-licensing.md) - [Authenticate with Demandbase APIs](https://developer.demandbase.com/docs/authenticate-with-demandbase-apis.md) - [Migrating from Legacy Tokens to API Keysets](https://developer.demandbase.com/docs/migrating-from-legacy-tokens-to-api-keysets.md) - B2B API - [Overview](https://developer.demandbase.com/docs/b2b-overview.md) - [Fields Available](https://developer.demandbase.com/docs/fields-available.md) - [Authentication](https://developer.demandbase.com/docs/b2b-authentication.md) - [Make Your First Request](https://developer.demandbase.com/docs/b2b-make-your-first-request.md) - [Rate Limits](https://developer.demandbase.com/docs/b2b-rate-limits.md) - [Best Practices](https://developer.demandbase.com/docs/b2b-best-practices.md) - [Configuring Webhooks For Subscription API](https://developer.demandbase.com/docs/configuring-webhooks-for-subscription-api.md) - [FAQ](https://developer.demandbase.com/docs/faq.md) - [Credit Consumption Model](https://developer.demandbase.com/docs/credit-consumtion-model.md) - [Available Endpoints](https://developer.demandbase.com/docs/b2b-available-endpoints.md) - [Installed Technologies (Technographics)](https://developer.demandbase.com/docs/installed-tech.md) - [IV API to B2B API Migration](https://developer.demandbase.com/docs/iv-api-to-b2b-api-migration.md) - Data Export API - [Overview](https://developer.demandbase.com/docs/export-overview.md) - [Authentication](https://developer.demandbase.com/docs/authentication.md) - [Make Your First Request](https://developer.demandbase.com/docs/make-your-first-request.md) - [How To Use Filters](https://developer.demandbase.com/docs/how-to-use-filters.md) - [Rate Limits](https://developer.demandbase.com/docs/rate-limits.md) - [Handling Errors](https://developer.demandbase.com/docs/handling-errors.md) - [Available Endpoints](https://developer.demandbase.com/docs/available-endpoints.md) - [Entity Relationships](https://developer.demandbase.com/docs/entity-relationships.md) - [FAQ](https://developer.demandbase.com/docs/faq-1.md) - [Collections](https://developer.demandbase.com/docs/collections.md) - [Fields Available For Export](https://developer.demandbase.com/docs/available-fields.md) - Data Import API - [Overview](https://developer.demandbase.com/docs/import-overview.md) - [Authentication](https://developer.demandbase.com/docs/authentication-1.md) - [Make Your First Request](https://developer.demandbase.com/docs/make-your-first-request-1.md): Learn how to create an import job, submit data to it, and check the job status in the Demandbase Import API. - [Rate Limits](https://developer.demandbase.com/docs/rate-limits-1.md) - [CSV Record Matching And Data Mapping](https://developer.demandbase.com/docs/csv-record-matching-and-data-mapping.md) - [Importing Intent Activities](https://developer.demandbase.com/docs/importing-intent-activities.md) - [Available Endpoints](https://developer.demandbase.com/docs/copy-of-available-endpoints.md) - User Admin API - [Overview](https://developer.demandbase.com/docs/user-admin-overview.md) - [Authentication](https://developer.demandbase.com/docs/authentication-3.md) - [Available Endpoints](https://developer.demandbase.com/docs/available-endpoints-1.md) - Credit Usage API - [Overview](https://developer.demandbase.com/docs/credit-usage-overview.md) - [Authentication](https://developer.demandbase.com/docs/authentication-2.md) - [Available Endpoints](https://developer.demandbase.com/docs/available-endpoints-2.md) - Custom Sources API - [Overview](https://developer.demandbase.com/docs/custom-sources-overview.md) - Intent API - [Overview](https://developer.demandbase.com/docs/intentoverview.md) - [Authentication](https://developer.demandbase.com/docs/authentication-4.md) - [Limits and Pagination](https://developer.demandbase.com/docs/make-your-first-request-2.md) - [Make Your First Request](https://developer.demandbase.com/docs/make-your-first-request-3.md) - [Handling Errors](https://developer.demandbase.com/docs/handling-errors-1.md) - [Available Endpoints](https://developer.demandbase.com/docs/available-endpoints-3.md) - Demandbase Model Context Protocol (MCP) - [Demandbase MCP Overview](https://developer.demandbase.com/docs/mcp.md) - [Get Started with Demandbase MCP](https://developer.demandbase.com/docs/get-started-with-demandbase-mcp.md) - [Understand Demandbase MCP Credit Usage](https://developer.demandbase.com/docs/credit-consumption.md) - [Demandbase MCP Tools Overview](https://developer.demandbase.com/docs/demandbase-mcp-tools-overview.md) - [Demandbase MCP Tool Details](https://developer.demandbase.com/docs/demandbase-mcp-tool-details.md) - [Demandbase MCP Prompts by Role](https://developer.demandbase.com/docs/demandbase-mcp-workflows-by-role.md) - Demandbase MCP Connections - [ChatGPT](https://developer.demandbase.com/docs/chatgpt-1.md) - [Claude](https://developer.demandbase.com/docs/claude.md) - [Gemini](https://developer.demandbase.com/docs/gemini.md) - [Gong](https://developer.demandbase.com/docs/gong.md) - [Microsoft Copilot Studio](https://developer.demandbase.com/docs/copilot.md) - [Outreach](https://developer.demandbase.com/docs/outreach.md) - [Sendoso](https://developer.demandbase.com/docs/sendoso.md) - [Slack](https://developer.demandbase.com/docs/slack.md) - [Visual Studio Code](https://developer.demandbase.com/docs/vs-code.md) - [Build a Custom MCP Client](https://developer.demandbase.com/docs/custom-mcp-clients.md) - [Recommended AI Agent Instructions for Demandbase MCP](https://developer.demandbase.com/docs/instructions.md) - [Troubleshoot Demandbase MCP and Understand Unsupported Requests](https://developer.demandbase.com/docs/troubleshoot-demandbase-mcp-and-understand-unsupported-requests.md) - [Demandbase Partner Tag](https://developer.demandbase.com/docs/partner-tag.md) - Demandbase Python SDK - [Demandbase Python SDK Overview](https://developer.demandbase.com/docs/getting_started_with_sdk.md) - [Demandbase Python SDK Reference](https://developer.demandbase.com/docs/python-sdk-api-reference.md) - [Demandbase Python SDK Common Errors, Troubleshooting, and FAQs](https://developer.demandbase.com/docs/python-sdk-error-handling.md) ## API Reference: Authentication - [Getting An Access Token](https://developer.demandbase.com/reference/authv1token.md): Getting started with Getting An Access Token. - [Generate an access token — Guide](https://developer.demandbase.com/reference/generate_access_token-guide.md): First-request guide for Generate an access token. - [Generate an access token](https://developer.demandbase.com/reference/generate_access_token.md): This endpoint issues an OAuth2 bearer token for authenticating with Demandbase APIs. ## API Reference: B2B API - [Sync API](https://developer.demandbase.com/reference/sync-api.md): Synchronous company, contact, matching, news, and logo operations. - [Search Contacts](https://developer.demandbase.com/reference/1.md) - [Search contacts](https://developer.demandbase.com/reference/contactsearch_1.md): Use this endpoint to search for individuals at specific companies. You can filter contacts by details such as first name, last name, email, location, job title, job level, and job function.… - [Search Companies](https://developer.demandbase.com/reference/search-companies.md) - [Search companies](https://developer.demandbase.com/reference/companysearch_1.md): Use this endpoint to search for companies based on a variety of attributes. You can search companies by name, website, ticker, location (city, state, country, ZIP), industry classification (NAICS,… - [Fetch Contact Details](https://developer.demandbase.com/reference/fetch-contact-details.md) - [Fetch contact details](https://developer.demandbase.com/reference/contactfetch.md): 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… - [Fetch Company Details](https://developer.demandbase.com/reference/fetch-company-details.md) - [Fetch company details](https://developer.demandbase.com/reference/companyfetch.md): Use this endpoint to fetch detailed information about a single company, including name, location, phone number, revenue, employee count, industry classification, and social media links. You can… - [Fetch Company News By Category](https://developer.demandbase.com/reference/fetch-company-news-by-category.md) - [Fetch company news by category](https://developer.demandbase.com/reference/companynewscategoryfetch.md): Use this endpoint to fetch recent news articles related to a specific company. You can filter articles by one or more news categories, such as acquisitions or leadership changes. Pagination is… - [Fetch Company News Feed](https://developer.demandbase.com/reference/fetch-company-news-feed.md) - [Fetch company news feed](https://developer.demandbase.com/reference/companynewsfetch.md): Use this endpoint to return a paginated list of recent news articles for a specific company. Unlike the `/news` endpoint, this feed does not require specifying news categories. It provides a general… - [Fetch Company Logo](https://developer.demandbase.com/reference/fetch-company-logo.md): Guide for Fetch Company Logo. - [Fetch company logo](https://developer.demandbase.com/reference/companylogofetch.md): Use this endpoint to fetch a company's logo in PNG format at the requested size. Supported sizes are 100, 200, or 400 pixels. If a logo in the specified size is not available, the API returns an… - [Match Companies and Contacts](https://developer.demandbase.com/reference/match-companies-and-contacts.md) - [Match companies and contact](https://developer.demandbase.com/reference/match_1.md): This endpoint matches companies and contacts against Demandbase's database based on provided firmographic and contact details. This endpoint supports batch matching by accepting an array of match… - [Asynchronous (Batch) API](https://developer.demandbase.com/reference/asynchronous-batch-api.md): Asynchronous bulk jobs for high-volume data retrieval and matching. - [Get Bulk Job Status — Guide](https://developer.demandbase.com/reference/getbulkjobstatus-guide.md): First-request guide for Get Bulk Job Status. - [Get Bulk Job Status](https://developer.demandbase.com/reference/getbulkjobstatus.md): Check the status of a bulk job using its unique job ID. This endpoint supports all bulk job types, including Company Fetch, Contact Fetch, and Match. Once the job completes successfully, the response… - [Match Companies and Contacts in Bulk — Guide](https://developer.demandbase.com/reference/match-guide.md): First-request guide for Match Companies and Contacts in Bulk. - [Match Companies and Contacts in Bulk](https://developer.demandbase.com/reference/match.md): Use this endpoint to enrich company and contact records in bulk using a CSV file upload. Each row in the file represents one enrichment request and must match the supported field structure. This… - [Create a Bulk Data Retrieval Job — Guide](https://developer.demandbase.com/reference/createbulkjob-guide.md): First-request guide for Create a Bulk Data Retrieval Job. - [Create a Bulk Data Retrieval Job](https://developer.demandbase.com/reference/createbulkjob.md): # Overview Create and run asynchronous bulk jobs to retrieve company or contact data using entity IDs or search filters. This API is ideal for large data exports with a file-based CSV output. You… - [Subscription API](https://developer.demandbase.com/reference/subscription-api.md): Subscription creation, updates, status, alerts, and lifecycle operations. - [Update an Existing Subscription — Guide](https://developer.demandbase.com/reference/updatesubscription-guide.md): First-request guide for Update an Existing Subscription. - [Update an Existing Subscription](https://developer.demandbase.com/reference/updatesubscription.md): Use this API to update an existing subscription. You must provide both the subscriptionId and subscriptionType to identify which subscription you want to modify. This endpoint supports partial and… - [Create a New Subscription — Guide](https://developer.demandbase.com/reference/updatesubscription_1-guide.md): First-request guide for Create a New Subscription. - [Create a New Subscription](https://developer.demandbase.com/reference/updatesubscription_1.md): Use this endpoint to create a subscription for monitoring updates to companies or DB Person records. Subscriptions allow you to receive change alerts via webhook and access historical alerts via API.… - [Get Subscription Entity IDs — Guide](https://developer.demandbase.com/reference/getsubscriptionentitydetails-guide.md): First-request guide for Get Subscription Entity IDs. - [Get Subscription Entity IDs](https://developer.demandbase.com/reference/getsubscriptionentitydetails.md): Retrieve all entity IDs (company or dbPerson) associated with a given subscription. The response is paginated and depends on the type of subscription: - For "company" or "companyFamilyTree"… - [Retrieve a Specific Subscription Alert — Guide](https://developer.demandbase.com/reference/getsubscriptionalertdetails-guide.md): First-request guide for Retrieve a Specific Subscription Alert. - [Retrieve a Specific Subscription Alert](https://developer.demandbase.com/reference/getsubscriptionalertdetails.md): Retrieve detailed alert updates for a specific subscription using its subscription ID and alert ID. Use `List Subscription Alerts` API to fetch latest alerts. This endpoint returns the specific… - [List Subscription Alerts — Guide](https://developer.demandbase.com/reference/getsubscriptionalertslist-guide.md): First-request guide for List Subscription Alerts. - [List Subscription Alerts](https://developer.demandbase.com/reference/getsubscriptionalertslist.md): Retrieve a paginated list of alerts generated for the specified subscription ID. Each alert includes: - `alertId`: unique identifier for the alert - `createdAt`: timestamp of when the alert was… - [Retrieve Subscription Details — Guide](https://developer.demandbase.com/reference/getsubscriptiondetails-guide.md): First-request guide for Retrieve Subscription Details. - [Retrieve Subscription Details](https://developer.demandbase.com/reference/getsubscriptiondetails.md): Fetch detailed information for a specific subscription using its subscription ID. The response includes: - Subscription type (e.g., company, dbPerson, companyNews, companyFamilyTree) - Frequency and… - [Delete a Subscription — Guide](https://developer.demandbase.com/reference/deletesubscription-guide.md): First-request guide for Delete a Subscription. - [Delete a Subscription](https://developer.demandbase.com/reference/deletesubscription.md): Permanently delete a subscription using its subscription ID. This operation removes the subscription from the system and halts all future notifications or alerts related to it. - [List Subscription Jobs — Guide](https://developer.demandbase.com/reference/subscriptionjobslistfetch-guide.md): First-request guide for List Subscription Jobs. - [List Subscription Jobs](https://developer.demandbase.com/reference/subscriptionjobslistfetch.md): Retrieve a paginated list of all subscription jobs created by your tenant. Results are returned in descending order by creation time (`createdAt`). You can apply filters based on time period, date… - [List Subscriptions — Guide](https://developer.demandbase.com/reference/getallsubscriptionsbyclientid-guide.md): First-request guide for List Subscriptions. - [List Subscriptions](https://developer.demandbase.com/reference/getallsubscriptionsbyclientid.md): Retrieve a list of all subscriptions associated with your tenant. You can filter results by one or more subscription types and paginate through the results. Results are returned in pages, with… - [Check Subscription Job Status — Guide](https://developer.demandbase.com/reference/getsubscriptionjobstatus-guide.md): First-request guide for Check Subscription Job Status. - [Check Subscription Job Status](https://developer.demandbase.com/reference/getsubscriptionjobstatus.md): Retrieve the current status of a bulk subscription job using its unique job ID. After you submit a create or update subscription job request, you’ll receive a job ID. This endpoint allows you to… - [Reference Tables](https://developer.demandbase.com/reference/reference-tables.md): Getting started with Reference Tables. - [Get reference data for an object — Guide](https://developer.demandbase.com/reference/getreferencedata-guide.md): First-request guide for Get reference data for an object. - [Get reference data for an object](https://developer.demandbase.com/reference/getreferencedata.md): Returns tenant-specific reference values for the requested object. This B2B API route is backed by the Data Export API reference service and accepts B2B API credentials. Object names are… ## API Reference: Intent API - [Company Intent](https://developer.demandbase.com/reference/company-intent.md): Retrieve company-level intent signals and research activity. - [Retrieve company intent data](https://developer.demandbase.com/reference/companyintent-1.md): Retrieves company intent signals filtered by company IDs, keyword set IDs, or keywords within a specified time range. You can optionally filter by intent strength or the number of people researching… ## API Reference: Data Export API - [Get Available Export Fields](https://developer.demandbase.com/reference/endpoints.md): Getting started with Get Available Export Fields. - [Export fields — Overview](https://developer.demandbase.com/reference/fetchfields-guide.md): First-request guide for Export fields. - [Export fields](https://developer.demandbase.com/reference/fetchfields.md): The Fields endpoint returns a list of all fields available for specific data export jobs. For `campaign` and `creative` export jobs, the query parameter `adReportType` is required. - [Create Export Job](https://developer.demandbase.com/reference/create-export-job.md): Getting started with Create Export Job. - [Create export job (Account, Opportunity, Person, Activity, Campaign, and Creative) — Guide](https://developer.demandbase.com/reference/createexportjob-guide.md): First-request guide for Create export job (Account, Opportunity, Person, Activity, Campaign, and Creative). - [Create export job (Account, Opportunity, Person, Activity, Campaign, and Creative)](https://developer.demandbase.com/reference/createexportjob.md): Creates a data export job for any supported entity type. - [Create account list export job — Guide](https://developer.demandbase.com/reference/fetchaccountlistjob-guide.md): First-request guide for Create account list export job. - [Create account list export job](https://developer.demandbase.com/reference/fetchaccountlistjob.md): Create a job to export all account lists or the account members of one or more specified account lists. - [Create person list export job — Guide](https://developer.demandbase.com/reference/fetchpersonlistjob-guide.md): First-request guide for Create person list export job. - [Create person list export job](https://developer.demandbase.com/reference/fetchpersonlistjob.md): Create a job to export all person lists or the person members of one or more specified person lists. - [Get Job Details](https://developer.demandbase.com/reference/get-job-details.md): Getting started with Get Job Details. - [Returns a list of submitted export jobs. — Guide](https://developer.demandbase.com/reference/fetchexportjobsinfo-guide.md): First-request guide for Returns a list of submitted export jobs.. - [Returns a list of submitted export jobs.](https://developer.demandbase.com/reference/fetchexportjobsinfo.md): Returns export jobs submitted for the authenticated tenant. Use the query parameters to filter, sort, and paginate the results. - [Check status of a data export job — Guide](https://developer.demandbase.com/reference/checkexportjobstatus-guide.md): First-request guide for Check status of a data export job. - [Check status of a data export job](https://developer.demandbase.com/reference/checkexportjobstatus.md): Returns the current job status. Finished jobs include a download URL when a result file is available; download URLs are valid for 24 hours. - [Get Reference Data](https://developer.demandbase.com/reference/get-reference-data.md): Getting started with Get Reference Data. - [Get available reference objects — Guide](https://developer.demandbase.com/reference/get-reference-guide.md): First-request guide for Get available reference objects. - [Get available reference objects](https://developer.demandbase.com/reference/get-reference.md): Returns the reference objects available through the Export API, including the endpoint for retrieving each object's data. - [Get reference data fields for an object — Guide](https://developer.demandbase.com/reference/get-support-object-guide.md): First-request guide for Get reference data fields for an object. - [Get reference data fields for an object](https://developer.demandbase.com/reference/get-support-object.md): Returns the records for one supported reference object. Object-name matching is case-insensitive. ## API Reference: Data Import API - [CSV Record Matching and Data Mapping](https://developer.demandbase.com/reference/csv-data-mapping.md) - [Import Job](https://developer.demandbase.com/reference/import-job.md): Getting started with Import Job. - [Create an import job — Guide](https://developer.demandbase.com/reference/post_job-guide.md): First-request guide for Create an import job. - [Create an import job](https://developer.demandbase.com/reference/post_job.md): Create a new job to perform a Data Import. This is prerequisite before posting a file with records to be imported. - [Sources — Guide](https://developer.demandbase.com/reference/get_entitytype-sources-guide.md): First-request guide for Sources. - [Sources](https://developer.demandbase.com/reference/get_entitytype-sources.md): Returns a list of eligible sources. - [Submit import data — Guide](https://developer.demandbase.com/reference/put_job-id-data-guide.md): First-request guide for Submit import data. - [Submit import data](https://developer.demandbase.com/reference/put_job-id-data.md): This endpoint is used to submit the data file to an existing import job identified by the path parameter {id}. Submitting the data file triggers the asynchronous processing of the data. You can… - [Jobs list — Guide](https://developer.demandbase.com/reference/get_jobs-guide.md): First-request guide for Jobs list. - [Jobs list](https://developer.demandbase.com/reference/get_jobs.md): Returns a list of import jobs. This provides an overview of all historical and current data import activities within the Demandbase platform. - [Job status — Guide](https://developer.demandbase.com/reference/get_job-id-guide.md): First-request guide for Job status. - [Job status](https://developer.demandbase.com/reference/get_job-id.md): Use this endpoint to retrieve the current status and relevant details of a specific data import job. The job is identified by the unique path parameter {id} that was returned when the job was… - [Activities Management](https://developer.demandbase.com/reference/activities-management.md): Getting started with Activities Management. - [Create New Activity Type — Guide](https://developer.demandbase.com/reference/post_activity-type-guide.md): First-request guide for Create New Activity Type. - [Create New Activity Type](https://developer.demandbase.com/reference/post_activity-type.md): Create a new activity type on your Demandbase tenant. - [List Activity Types — Guide](https://developer.demandbase.com/reference/get_activity-type-guide.md): First-request guide for List Activity Types. - [List Activity Types](https://developer.demandbase.com/reference/get_activity-type.md): Get all activity types currently configured on your Demandbase tenant - [Update Activity Type — Guide](https://developer.demandbase.com/reference/put_activity-type-activitytypeid-guide.md): First-request guide for Update Activity Type. - [Update Activity Type](https://developer.demandbase.com/reference/put_activity-type-activitytypeid.md): Update an existing activity type on your Demandbase tenant. Use the activity type ID in the URI (via `PUT /activity_type/{activityTypeId}`). - [Activity Type Lookup — Guide](https://developer.demandbase.com/reference/get_activity-type-identifier-guide.md): First-request guide for Activity Type Lookup. - [Activity Type Lookup](https://developer.demandbase.com/reference/get_activity-type-identifier.md): Retrieve details of an activity type for data import. ## API Reference: Admin API - [User](https://developer.demandbase.com/reference/user.md): Getting started with User. - [Create new user — Guide](https://developer.demandbase.com/reference/post_admin-v1-user-guide.md): First-request guide for Create new user. - [Create new user](https://developer.demandbase.com/reference/post_admin-v1-user.md):