List Subscription Jobs

get

https://uapi.demandbase.com/data/b2b/v1/subscriptions/jobs

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 range, job status, and job type.

Period can be specified as day, month, or year. If day is selected, you can specify a range of days (e.g., 2024-09-01 to 2024-09-07). For month, you can specify a range of months (e.g., 2024-09 to 2024-10). For year, you can specify a range of years (e.g., 2024 to 2025 for the entire year).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

period

string

enum

The time period type you want to filter jobs by.

Valid values:

day
month
year

Allowed:

start

string

Start day/month/year(inclusive) for the selected period.

Start format depends on the period type:

day: YYYY-MM-DD (e.g., 2024-09-01)
month: YYYY-MM (e.g., 2024-09)
year: YYYY (e.g., 2024)

end

string

End day/month/year(inclusive) for the selected period.

End format depends on the period type:

day: YYYY-MM-DD (e.g., 2024-09-30)
month: YYYY-MM (e.g., 2024-10)
year: YYYY (e.g., 2025)

jobStatus

string

enum

Filter jobs by their status.

Valid values:

failed
accepted
processing
finished

Allowed:

jobType

string

enum

Type of subscription job to filter by.

Valid values:

notificationSubscriptionCreate
notificationSubscriptionUpdate

Allowed:

page

string

Page number to retrieve. Must be 1 or higher.

perPage

string

Number of results per page (max 50).

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/xml

200List of subscription jobs returned successfully.

400Invalid input or unsupported query parameters.

401Authentication is required or token is invalid.