Drippay

Drippay Usage API

Record metered usage. Creates charges when a pricing plan matches.

GitHub OpenAPI
Business capability
Usage Metering BC-4250.10

Operations 6

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/usage Record usage and charge immediately · Record usage and charge #
Ask an LLM
“How do I bill a customer for usage and wait until the charge is settled on-chain?”
“Can I charge by my own external customer ID instead of the Drip ID?”
Tell an agent
Charge customer {customerId} for {quantity} {usageType} with key {idempotencyKey} and wait for settlement.
Record settled usage of {quantity} for external customer {externalCustomerId}, key {idempotencyKey}.
GET /v1/usage List recent usage events and charges · List usage events #
Ask an LLM
“What usage has been recorded recently, with the charges it created?”
“Can I see recent billable usage for just one customer?”
Tell an agent
List recent usage events.
Show the last {limit} usage events for customer {customerId}.
POST /v1/usage/async Record usage and charge in the background · Record usage (async) #
Ask an LLM
“Can I record billable usage without waiting for the charge to settle?”
“How will I know whether a background usage charge succeeded or failed?”
Tell an agent
Record {quantity} {usageType} for {customerId} asynchronously with key {idempotencyKey}.
Queue a background charge for customer {customerId}, idempotency key {idempotencyKey}.
POST /v1/usage/internal Track usage without billing · Record internal usage (no billing) #
Ask an LLM
“How do I track internal team usage without charging anyone?”
“Can I log a pilot customer's usage for visibility but not bill it?”
Tell an agent
Log {quantity} {usageType} for {customerId} as internal, non-billed usage, key {idempotencyKey}.
Record one unbilled usage event with key {idempotencyKey}.
POST /v1/usage/internal/batch Track unbilled usage at high throughput · Record internal usage (batched, high throughput) #
Ask an LLM
“What should I use to send over a million unbilled usage events a day?”
“Is there a buffered, bulk-insert way to record internal usage?”
Tell an agent
Send internal usage {idempotencyKey} for {customerId} through the high-throughput buffer.
Record unbilled {usageType} usage in batched mode with key {idempotencyKey}.
GET /v1/usage/quota Check this month's event usage against plan quota · Get current-month event usage vs plan quota (API-key auth) #
Ask an LLM
“Have I exceeded my monthly event quota on Drip?”
“When does my event quota reset, and what does overage cost per event?”
Tell an agent
Check my current-month event usage against my plan quota.
Tell me whether my event quota is exceeded and when it resets.

Documentation

📖
Documentation
https://docs.usedrip.ai/
📖
APIReference
https://docs.usedrip.ai/api-reference
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/drippay/refs/heads/main/authentication/drippay-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/drippay/refs/heads/main/openapi/drippay-usage-api-openapi.yml

Other Resources

🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/drippay/refs/heads/main/conventions/drippay-conventions.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/drippay/refs/heads/main/conventions/drippay-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/drippay/refs/heads/main/errors/drippay-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/drippay/refs/heads/main/data-model/drippay-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/drippay/refs/heads/main/asyncapi/drippay-webhooks.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/drippay/refs/heads/main/conformance/drippay-conformance.yml
🔗
AgenticAccess
https://raw.githubusercontent.com/api-evangelist/drippay/refs/heads/main/agentic-access/drippay-agentic-access.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/drippay:drippay-usage-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

drippay-usage-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Drip Usage API
  description: '# Drip API


    **Usage-based billing + execution ledger.**


    ---


    ## 60-Second Quickstart (Core SDK)


    ### 1.'
  version: 1.0.0
  contact:
    name: Drip Support
    email: support@drippay.dev
  x-logo:
    url: https://drippay.dev/logo.svg
    altText: Drip
servers:
- url: https://api.drippay.dev
  description: Production
- url: http://localhost:3001
  description: Development
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (57 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/drippay/refs/heads/main/openapi/drippay-usage-api-openapi.yml