List all date-driven terms
Returns a list of date-driven terms. NOTE: QuickBooks Desktop does not support pagination for date-driven terms; hence, there is no cursor
parameter. Users typically have few date-driven terms.
Authorizations
Your Conductor secret key using Bearer auth (e.g., "Authorization: Bearer {{YOUR_SECRET_KEY}}"
).
Headers
The ID of the EndUser to receive this request (e.g., "Conductor-End-User-Id: {{END_USER_ID}}"
).
"end_usr_1234567abcdefg"
Query Parameters
Filter for specific date-driven terms by their QuickBooks-assigned unique identifier(s).
IMPORTANT: If you include this parameter, QuickBooks will ignore all other query parameters for this request.
NOTE: If any of the values you specify in this parameter are not found, the request will return an error.
["80000001-1234567890"]
Filter for specific date-driven terms by their name(s), case-insensitive. Like id
, name
is a unique identifier for a date-driven term.
IMPORTANT: If you include this parameter, QuickBooks will ignore all other query parameters for this request.
NOTE: If any of the values you specify in this parameter are not found, the request will return an error.
["2% 5th Net 25th"]
The maximum number of objects to return.
IMPORTANT: QuickBooks Desktop does not support cursor-based pagination for date-driven terms. This parameter will limit the response size, but you cannot fetch subsequent results using a cursor. For pagination, use the name-range parameters instead (e.g., nameFrom=A&nameTo=B
).
When this parameter is omitted, the endpoint returns all date-driven terms without limit, unlike paginated endpoints which default to 150 records. This is acceptable because date-driven terms typically have low record counts.
x >= 1
10
Filter for date-driven terms that are active, inactive, or both.
active
, all
, inactive
"active"
Filter for date-driven terms updated on or after this date and time, in ISO 8601 format (YYYY-MM-DDTHH:mm:ss). If you only provide a date (YYYY-MM-DD), the time is assumed to be 00:00:00 of that day.
"2021-01-01T12:34:56.000Z"
Filter for date-driven terms updated on or before this date and time, in ISO 8601 format (YYYY-MM-DDTHH:mm:ss). If you only provide a date (YYYY-MM-DD), the time is assumed to be 23:59:59 of that day.
"2021-02-01T12:34:56.000Z"
Filter for date-driven terms whose name
contains this substring, case-insensitive. NOTE: If you use this parameter, you cannot also use nameStartsWith
or nameEndsWith
.
"ABC"
Filter for date-driven terms whose name
starts with this substring, case-insensitive. NOTE: If you use this parameter, you cannot also use nameContains
or nameEndsWith
.
"ABC"
Filter for date-driven terms whose name
ends with this substring, case-insensitive. NOTE: If you use this parameter, you cannot also use nameContains
or nameStartsWith
.
"ABC"
Filter for date-driven terms whose name
is alphabetically greater than or equal to this value.
"A"
Filter for date-driven terms whose name
is alphabetically less than or equal to this value.
"Z"
Response
The type of object. This value is always "list"
.
"list"
"list"
The endpoint URL where this list can be accessed.
"/v1/quickbooks-desktop/date-driven-terms"
The array of date-driven terms.