Overview

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 case-insensitive.

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/reference/JobLevel \
  --header "Authorization: Bearer $DB_API_KEY" \
  --header "Accept: application/json"

{
  "objectType": "JobLevel",
  "data": [
    {
      "id": 1,
      "name": "C Level"
    }
  ]
}

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. Reference data fetched successfully.

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

Rules

• Use GET with the path /reference/{object}.
• Required inputs: object.
• 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