Overview

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 will contain a signed `resultsUrl` for downloading the results. Important notes: - The `resultsUrl` is included **only when the job status is `finished`** - The URL remains valid for **24 hours** - If the job fails, an `errorMessage` field will be present in the response explaining the reason **CSV Results Format:** - The `resultsUrl` points to a CSV file containing the requested data - CSV column headers correspond exactly to the field names sp…

Quickstart

Follow these two steps to make a request and recognize a successful response.

curl --request GET \
  --url https://uapi.demandbase.com/data/b2b/v1/job/example \
  --header "Authorization: Bearer $DB_API_KEY" \
  --header "Accept: application/json"

{
  "jobName": "jobNameTest",
  "jobStatus": "finished",
  "jobType": "contactfetch",
  "jobId": "f546c341-2dc3-4797-b43d-59ac0d334346",
  "createdAt": "2024-09-16T04:46:21.684Z",
  "updatedAt": "2024-09-02T06:07:44.550Z",
  "resultsUrl": "https://uapi-results.db-data-api-dev.demandbase.com/bulkjobs/companyfetch/0ab5c350-c6d2-4dcc-a9cd-dbba521f468d/response/c1ebe044-0c93-4643-b4bf-9ab1ea9b4ee3.csv?Policy=..."
}

Request anatomy

Build the request from the method, path, parameters, and payload described below.

Parameters

Request body

This endpoint does not define a JSON request body.

Response anatomy

The endpoint returns 200 for the documented success case. Bulk job status fetched successfully. Results URL is present only for finished jobs.

The response schema does not enumerate fields; inspect the example response and status code.

Rules

• Use GET with the path /job/{jobId}.
• Required inputs: jobId.
• Authenticate every request with a valid Demandbase access token.
• This endpoint does not require a JSON request body.

Filters

The published schema exposes the following endpoint inputs. Use the location column to place each value correctly.

Errors

Handle non-success responses explicitly so your integration can report actionable failures.

Next steps

Back to top