Sign in

v1

latestOpenAPI 3.0.12026-07-26152262362.2 KB
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

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.