Get a list of contracts
Retrieves a cursor-paginated list of contracts in the environment, fetched live from the connected billing provider. Each contract is enriched with a preview of its upcoming (next) invoice when one is available. Returns an empty list when no billing provider is connected. Supports filtering by customer external ID, state, and name.
Authorizations
Server API Key
Headers
Account ID — optional when authenticating with a user JWT (Bearer token); falls back to the user's first membership. Ignored for API-key auth.
Environment ID — required when authenticating with a user JWT (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the key).
Query Parameters
Maximum number of items to return
1 <= x <= 100Return items that come after this cursor
255Return items that come before this cursor
255Filter by the exact external ID of the customer the contract belongs to
255Filter by contract state. Supports comma-separated values for multiple states
255Filter by exact contract name
255