Drippay

Drippay Tax API

Sales tax configuration: customer tax addresses, exemptions, business registrations, and jurisdiction rates. Requires a secret key with ADMIN role and full mode (`SIMPLE_MODE=false`).

Documentation GitHub OpenAPI

Business capability

Subscription Tax Management BC-4250.60

Operations 12

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

PUT /v1/customers/{id}/address Set a customer's billing address · Set a customer's billing address #

Ask an LLM

“How do I save or replace a customer's billing address for tax purposes?”

“Does setting a customer address trigger address validation?”

Tell an agent

Set the billing address for customer {id}.

Replace the address on file for {id} and validate it.

GET /v1/customers/{id}/address Get a customer's billing address · Get the customer's stored address #

Ask an LLM

“What billing address do I have on file for a customer?”

“Can I check a customer's stored address used for tax?”

Tell an agent

Show the stored address for customer {id}.

Get the billing address on file for {id}.

DELETE /v1/customers/{id}/address Remove a customer's address · Remove the customer's address #

Ask an LLM

“Can I delete the stored address from a customer?”

“How do I clear a customer's billing address?”

Tell an agent destructive · confirm first

Remove the address from customer {id}.

Delete the billing address stored for {id}.

POST /v1/customers/{id}/tax-exemption Add a tax exemption for a customer · Create a customer tax exemption #

Ask an LLM

“How do I mark a customer as tax exempt?”

“Can I exempt a single customer from tax without changing my registrations?”

Tell an agent

Create a tax exemption for customer {id}.

Make {id} tax exempt.

GET /v1/customers/{id}/tax-exemptions List a customer's active tax exemptions · List active tax exemptions for a customer #

Ask an LLM

“Which tax exemptions are currently active for a customer?”

“Is a given customer exempt from tax anywhere?”

Tell an agent

List active tax exemptions for customer {id}.

Show the exemptions on file for {id}.

DELETE /v1/customers/{id}/tax-exemptions/{eid} Deactivate a customer tax exemption · Deactivate a customer tax exemption #

Ask an LLM

“How do I revoke a customer's tax exemption once it expires?”

“Can I deactivate just one exemption for a customer?”

Tell an agent destructive · confirm first

Deactivate tax exemption {eid} for customer {id}.

Remove exemption {eid} from {id}.

POST /v1/customers/{id}/tax-preview Preview tax on a hypothetical charge · Preview tax for a hypothetical charge amount #

Ask an LLM

“How much tax would a customer pay on a given charge amount?”

“Can I estimate tax for a customer before actually charging them?”

Tell an agent

Preview tax for a hypothetical charge to customer {id}.

Estimate the tax {id} would owe on a charge.

POST /v1/tax-registrations Add a tax registration for the business · Create a tax registration for the business #

Ask an LLM

“How do I register my business to collect tax in a new jurisdiction?”

“Can I add a VAT or sales tax registration to my account?”

Tell an agent

Create a tax registration for my business.

Add a new jurisdiction registration for tax collection.

GET /v1/tax-registrations List the business's tax registrations · List active tax registrations for the business #

Ask an LLM

“Which jurisdictions is my business registered to collect tax in?”

“What tax registrations are active on my account?”

Tell an agent

List my active tax registrations.

Show where my business is registered for tax.

DELETE /v1/tax-registrations/{id} Deactivate a tax registration · Deactivate a tax registration #

Ask an LLM

“How do I stop collecting tax in a jurisdiction I've deregistered from?”

“Can I deactivate one of my business's tax registrations?”

Tell an agent destructive · confirm first

Deactivate tax registration {id}.

Remove business tax registration {id}.

GET /v1/tax-rates List the global tax rate catalogue · List the seeded global tax rate catalogue #

Ask an LLM

“What tax rates are built into the global catalogue?”

“Can I see the seeded tax rates by jurisdiction?”

Tell an agent

List the global tax rate catalogue.

Show all seeded tax rates.

GET /v1/tax-config/readiness Check tax configuration readiness · Check whether the merchant's tax configuration is production-ready #

Ask an LLM

“Is my tax setup production-ready, and which jurisdictions aren't covered?”

“Which of my customers are missing an address for tax calculation?”

Tell an agent

Check whether my tax configuration is production-ready.

Report tax setup warnings and uncovered jurisdictions.

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-tax-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

openapi: 3.2.0
info:
  title: Drip Tax 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:
- name: Tax
  description: 'Sales tax configuration: customer tax addresses, exemptions, business registrations, and jurisdiction rates. Requires a secret key with ADMIN role and full mode (`SIMPLE_MODE=false`).'
paths:
  /v1/customers/{id}/address:
    put:
      operationId: setCustomerAddress
      summary: Set a customer's billing address
      tags:
      - Tax
      description: 'Set or replace the customer''s billing address. Triggers address validation via the configured provider (default: format-only). Requires an ADMIN secret key.'
      parameters:
      - schema:
          type: string
        in: path
        name: id
        required: true
      responses:
        '200':
          description: Default Response
    get:
      operationId: getCustomerAddress
      summary: Get the customer's stored address
      tags:
      - Tax
      parameters:
      - schema:
          type: string
        in: path
        name: id
        required: true
      responses:
        '200':
          description: Default Response
    delete:
      operationId: removeCustomerAddress
      summary: Remove the customer's address
      tags:
      - Tax
      parameters:
      - schema:
          type: string
        in: path
        name: id
        required: true
      responses:
        '200':
          description: Default Response
  /v1/customers/{id}/tax-exemption:
    post:
      operationId: createCustomerTaxExemption
      summary: Create a customer tax exemption
      tags:
      - Tax
      parameters:
      - schema:
          type: string
        in: path
        name: id
        required: true
      responses:
        '200':
          description: Default Response
  /v1/customers/{id}/tax-exemptions:
    get:
      operationId: listCustomerTaxExemptions
      summary: List active tax exemptions for a customer
      tags:
      - Tax
      parameters:
      - schema:
          type: string
        in: path
        name: id
        required: true
      responses:
        '200':
          description: Default Response
  /v1/customers/{id}/tax-exemptions/{eid}:
    delete:
      operationId: removeCustomerTaxExemption
      summary: Deactivate a customer tax exemption
      tags:
      - Tax
      parameters:
      - schema:
          type: string
        in: path
        name: id
        required: true
      - schema:
          type: string
        in: path
        name: eid
        required: true
      responses:
        '200':
          description: Default Response
  /v1/customers/{id}/tax-preview:
    post:
      operationId: previewCustomerTax
      summary: Preview tax for a hypothetical charge amount
      tags:
      - Tax
      parameters:
      - schema:
          type: string
        in: path
        name: id
        required: true
      responses:
        '200':
          description: Default Response
  /v1/tax-registrations:
    post:
      operationId: createTaxRegistration
      summary: Create a tax registration for the business
      tags:
      - Tax
      responses:
        '200':
          description: Default Response
    get:
      operationId: listTaxRegistrations
      summary: List active tax registrations for the business
      tags:
      - Tax
      responses:
        '200':
          description: Default Response
  /v1/tax-registrations/{id}:
    delete:
      operationId: removeTaxRegistration
      summary: Deactivate a tax registration
      tags:
      - Tax
      parameters:
      - schema:
          type: string
        in: path
        name: id
        required: true
      responses:
        '200':
          description: Default Response
  /v1/tax-rates:
    get:
      operationId: listTaxRates
      summary: List the seeded global tax rate catalogue
      tags:
      - Tax
      responses:
        '200':
          description: Default Response
  /v1/tax-config/readiness:
    get:
      operationId: getTaxConfigReadiness
      summary: Check whether the merchant's tax configuration is production-ready
      tags:
      - Tax
      description: 'Returns a structured report of the merchant''s tax setup: active registrations, customer address coverage, uncovered jurisdictions, and actionable warnings with stable codes. Non-enforcing — merchants can always bill; this is a configuration quality check, not a gate.'
      responses:
        '200':
          description: Default Response
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'API key from Drip Dashboard. Format: `sk_live_...` or `sk_test_...`'

Drippay Tax API

Operations 12

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification