First-request guide for Activity Type Lookup.
Activity Type Lookup
Activity Type Lookup
Overview
Retrieve details of an activity type for data import.
Call the endpoint
Send a GET request to /activity_type/{identifier} with the required authentication and parameters.
Quickstart
Follow these two steps to make a request and recognize a successful response.
Make a request
curl --request GET \
--url https://uapi.demandbase.com/import/v1/activity_type/example \
--header "Authorization: Bearer $DB_API_KEY" \
--header "Accept: application/json"Read the response
{
"activityType": {
"name": "example",
"label": "example",
"description": "example"
},
"fields": [
{
"fieldName": "example",
"fieldDataType": "example",
"defaultField": true,
"isRequiredForCsvImport": true
}
]
}Request anatomy
Build the request from the method, path, parameters, and payload described below.
Parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
identifier | path | string | Required | The unique identifier for the activity type. This should be the activity type ID. |
Request body
This endpoint does not define a JSON request body.
Response anatomy
The endpoint returns 200 for the documented success case. Inspect the response fields below.
The response schema does not enumerate fields; inspect the example response and status code.
Rules
- Use
GETwith the path/activity_type/{identifier}. - Required inputs: identifier.
- 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.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
identifier | path | string | Required | The unique identifier for the activity type. This should be the activity type ID. |
Errors
Handle non-success responses explicitly so your integration can report actionable failures.
| Status | Meaning |
|---|---|
400 | Request failed. |
404 | Request failed. |
500 | Request failed. |