Drippay

Drippay Contracts API

Per-customer commercial agreements with custom pricing, prepaid commits, and spend caps. All contract endpoints require a secret key (`sk_*`) with the `ADMIN` role.

Documentation GitHub OpenAPI

Business capability

Subscription Contracting BC-4240.20

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/contracts Create a per-customer contract · Create a contract #

Ask an LLM

“How do I set up an enterprise deal with a prepaid commit for a customer?”

“Can a contract cap how much a customer is billed?”

Tell an agent

Create contract {name} for customer {customerId} starting {startDate}.

Create a {discountPct}% discount contract {name} for {customerId} from {startDate} to {endDate}.

GET /v1/contracts List customer contracts · List contracts #

Ask an LLM

“Which contracts does a particular customer have with us?”

“Can I see only my active contracts, newest first?”

Tell an agent

List contracts for customer {customerId}.

Show all contracts with status {status}.

GET /v1/contracts/{id} Get a contract with balance and overrides · Get a contract #

Ask an LLM

“How much prepaid balance is left on a customer's contract?”

“What price overrides are on one specific contract?”

Tell an agent

Get contract {id}.

Show the prepaid balance and price overrides on contract {id}.

PATCH /v1/contracts/{id} Amend an active contract's terms · Amend a contract #

Ask an LLM

“How do I extend the end date on an existing contract?”

“Which contract terms can't be changed after it's created?”

Tell an agent

Extend contract {id} to end on {endDate}.

Change the discount on existing contract {id} to {discountPct}%.

DELETE /v1/contracts/{id} Cancel a contract permanently · Cancel a contract #

Ask an LLM

“Can a cancelled contract ever be reactivated?”

“What happens to the remaining prepaid balance when I cancel a contract?”

Tell an agent destructive · confirm first

Cancel contract {id}.

Terminate the customer agreement {id} so its overrides stop applying.

POST /v1/contracts/{id}/overrides Add a negotiated price override to a contract · Add a price override #

Ask an LLM

“How do I give one customer a lower per-unit rate than the default plan?”

“Can I update an existing unit price override on a contract?”

Tell an agent

Set {unitType} to {unitPriceUsd} per unit on contract {id}.

Add a negotiated rate of {unitPriceUsd} for {unitType} to contract {id}.

DELETE /v1/contracts/{id}/overrides/{unitType} Remove a price override from a contract · Remove a price override #

Ask an LLM

“How do I put a customer back on the default rate for one usage type?”

“Does the unit type have to match exactly when removing an override?”

Tell an agent destructive · confirm first

Remove the {unitType} price override from contract {id}.

Revert contract {id} to the default plan rate for {unitType}.

Drippay Contracts API

Operations 7

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification