Drippay

Drippay Invoices API

Generate, issue, and manage invoices. Supports usage-based and subscription-based billing periods.

Documentation GitHub OpenAPI

Business capability

Invoicing & Statement Management BC-4250.30

Operations 13

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/invoices/generate Generate a draft invoice from usage charges · Generate invoice from charges #

Ask an LLM

“How do I turn a customer's usage charges for a period into an invoice?”

“Can I build an invoice that only includes charges that have already settled?”

Tell an agent

Generate an invoice from charges for customer {customerId} between {periodStart} and {periodEnd}.

Draft a usage invoice for {customerId} from {periodStart} to {periodEnd}, due {dueDate}.

POST /v1/invoices/generate-from-subscription Generate a draft invoice for a subscription period · Generate invoice from subscription #

Ask an LLM

“Can I invoice a subscription for a partial period with proration?”

“Is it possible to include usage charges on a subscription invoice?”

Tell an agent

Generate an invoice for subscription {subscriptionId} of customer {customerId}.

Invoice subscription {subscriptionId} for {customerId} and include usage charges: {includeUsageCharges}.

GET /v1/invoices List invoices · List invoices #

Ask an LLM

“Which invoices are still unpaid?”

“Can I list one customer's invoices within a date range?”

Tell an agent

List invoices with status {status}.

Show invoices for customer {customerId} from {startDate} to {endDate}.

GET /v1/invoices/{id} Get an invoice · Get invoice #

Ask an LLM

“What line items and totals are on a specific invoice?”

“Can I fetch one invoice by its ID?”

Tell an agent

Show invoice {id}.

Get the details of invoice {id}.

PATCH /v1/invoices/{id} Edit terms and notes on a draft invoice · Update mutable invoice fields (DRAFT only) #

Ask an LLM

“Can I add a PO number or change NET terms on an invoice before it's issued?”

“Are invoice notes still editable after the invoice is issued?”

Tell an agent

Update the payment terms and PO number on draft invoice {id}.

Change the customer notes on draft invoice {id}.

POST /v1/invoices/{id}/line-items Add a one-off line item to a draft invoice · Add an ad-hoc line item to a draft invoice #

Ask an LLM

“How do I add a setup fee or manual adjustment to an invoice?”

“Can I append a line item after an invoice has been issued?”

Tell an agent

Add a one-off line item to draft invoice {id}.

Append a setup fee line to invoice {id}.

POST /v1/invoices/{id}/issue Issue a draft invoice · Issue invoice #

Ask an LLM

“How do I finalize a draft invoice so it's pending payment?”

“What happens to a draft invoice when I issue it?”

Tell an agent

Issue invoice {id}.

Finalize draft invoice {id} and send it for payment.

POST /v1/invoices/{id}/paid Mark an invoice as paid · Mark invoice as paid #

Ask an LLM

“Can I record a partial payment against an invoice?”

“How do I mark an invoice settled when the customer paid outside the system?”

Tell an agent

Mark invoice {id} as paid in full.

Record a payment of {amount} on invoice {id}.

POST /v1/invoices/{id}/void Void an invoice · Void invoice #

Ask an LLM

“How do I cancel an invoice that was sent by mistake?”

“Can an invoice be voided once it's been paid?”

Tell an agent destructive · confirm first

Void invoice {id} because {reason}.

Cancel invoice {id} with reason {reason}.

GET /v1/invoices/summary Get invoice statistics · Get invoice summary #

Ask an LLM

“What are my aggregate invoice totals across the business?”

“How much am I owed across all outstanding invoices?”

Tell an agent

Show my invoice summary stats.

Give me aggregated invoice totals for the business.

GET /v1/invoices/{id}/pdf Download an invoice PDF · Download invoice PDF #

Ask an LLM

“Can I get a PDF copy of an invoice to send to a customer?”

“Where do I download an invoice as a PDF file?”

Tell an agent

Download the PDF for invoice {id}.

Generate a PDF of invoice {id}.

GET /v1/subscriptions/{id}/upcoming-invoice Preview a subscription's upcoming invoice · Preview the upcoming invoice for a subscription #

Ask an LLM

“What will a customer's next subscription invoice look like, usage included?”

“Can I see the upcoming bill for a subscription without creating anything?”

Tell an agent

Preview the upcoming invoice for subscription {id}.

Show what subscription {id} will be billed next period.

POST /v1/invoices/preview Preview an invoice for any period · Preview an invoice for a customer over an arbitrary period #

Ask an LLM

“Can I preview what a customer would be invoiced over an arbitrary date range?”

“What would an invoice for a custom period come to before I generate it?”

Tell an agent

Preview an invoice for a customer over a custom period.

Estimate an arbitrary-period invoice without saving it.

Drippay Invoices API

Operations 13

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification