Contracts

List contracts

Lists the contracts held by the specified customer. Callable by a T1/T2 PartnerOps principal for its own tenant or any descendant tenant. Read access requires contractsReadOnly, contractsViewer, or a write-capable role (without contractsReadOnly). User API tokens must include the matching permission in their scope.

get/customers/{customerID}/contracts

Request

  • Base URL
    https://api.doit.com
  • URL
    https://api.doit.com/customers/{customerID}/contracts
  • Auth
    • API key in header Authorization
    • or API key in header X-Tenant-Id and API key in header Authorization

Path parameters

customerIDstring required

The customer (tenant) whose contracts are requested.

Response

OK - The request succeeded.

idstring

The unique identifier of the contract.

customerIdstring

The customer (tenant) that holds the contract.

typestring

The immutable contract type.

status'draft' | 'scheduled' | 'active' | 'cancelled' | 'expired' | 'superseded'

The contract status.

namestring

The contract name.

startDatestring date-time nullable

The contract start date.

endDatestring date-time nullable

The contract end date.

renewalPolicy'auto' | 'manual' | 'fixed'

The renewal policy.

currentVersionNumberinteger nullable

The current version number of the contract.

timeCreatedstring date-time

When the contract was created.

Changes

No recorded changes to this operation across all 1 revision of this API.