Skip to main content
GET
/
quickbooks-desktop
/
date-driven-terms
JavaScript
import Conductor from 'conductor-node';

const conductor = new Conductor({
  apiKey: 'sk_conductor_...',
});

const dateDrivenTerms = await conductor.qbd.dateDrivenTerms.list({
  conductorEndUserId: 'end_usr_1234567abcdefg',
});

console.log(dateDrivenTerms.data);
{
  "objectType": "list",
  "url": "/v1/quickbooks-desktop/date-driven-terms",
  "data": [
    {
      "id": "80000001-1234567890",
      "objectType": "qbd_date_driven_term",
      "createdAt": "2025-01-01T12:34:56+00:00",
      "updatedAt": "2025-02-01T12:34:56+00:00",
      "revisionNumber": "1721172183",
      "name": "2% 5th Net 25th",
      "isActive": true,
      "dueDayOfMonth": 15,
      "gracePeriodDays": 2,
      "discountDayOfMonth": 5,
      "discountPercentage": "10"
    }
  ]
}

Authorizations

Authorization
string
header
required

Your Conductor secret key using Bearer auth (e.g., "Authorization: Bearer {{YOUR_SECRET_KEY}}").

Headers

Conductor-End-User-Id
string
required

The ID of the EndUser to receive this request (e.g., "Conductor-End-User-Id: {{END_USER_ID}}").

Example:

"end_usr_1234567abcdefg"

Query Parameters

ids
string[]

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.

Example:
["80000001-1234567890"]
names
string[]

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.

Example:
["2% 5th Net 25th"]
limit
integer

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.

Required range: x >= 1
Example:

10

status
enum<string>
default:active

Filter for date-driven terms that are active, inactive, or both.

Available options:
active,
all,
inactive
Example:

"active"

updatedAfter
string

Filter for date-driven terms updated on or after this date/time. Accepts the following ISO 8601 formats:

  • date-only (YYYY-MM-DD) - QuickBooks Desktop interprets the date as the start of the specified day in the local timezone of the end-user's computer (e.g., 2025-01-012025-01-01T00:00:00).
  • datetime without timezone (YYYY-MM-DDTHH:mm:ss) - QuickBooks Desktop interprets the timestamp in the local timezone of the end-user's computer.
  • datetime with timezone (YYYY-MM-DDTHH:mm:ss±HH:mm) - QuickBooks Desktop interprets the timestamp using the specified timezone.
Example:

"2025-01-01T12:34:56+00:00"

updatedBefore
string

Filter for date-driven terms updated on or before this date/time. Accepts the following ISO 8601 formats:

  • date-only (YYYY-MM-DD) - QuickBooks Desktop interprets the date as the end of the specified day in the local timezone of the end-user's computer (e.g., 2025-01-012025-01-01T23:59:59).
  • datetime without timezone (YYYY-MM-DDTHH:mm:ss) - QuickBooks Desktop interprets the timestamp in the local timezone of the end-user's computer.
  • datetime with timezone (YYYY-MM-DDTHH:mm:ss±HH:mm) - QuickBooks Desktop interprets the timestamp using the specified timezone.
Example:

"2025-02-01T12:34:56+00:00"

nameContains
string

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.

Example:

"ABC"

nameStartsWith
string

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.

Example:

"ABC"

nameEndsWith
string

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.

Example:

"ABC"

nameFrom
string

Filter for date-driven terms whose name is alphabetically greater than or equal to this value.

Example:

"A"

nameTo
string

Filter for date-driven terms whose name is alphabetically less than or equal to this value.

Example:

"Z"

Response

200 - application/json

Returns a list of date-driven terms.

objectType
string
required

The type of object. This value is always "list".

Allowed value: "list"
Example:

"list"

url
string
required

The endpoint URL where this list can be accessed.

Example:

"/v1/quickbooks-desktop/date-driven-terms"

data
The Date-Driven Term object · object[]
required

The array of date-driven terms.