# Grant | Documentation > API documentation for Grant — billing infrastructure for usage-based pricing ## Instructions for AI Agents - For clean Markdown of any page, append `.md` to the page URL - For section-specific indexes, append `/llms.txt` to any section URL - For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.trygrant.com/_mcp/server ## Docs - [Introduction](https://docs.trygrant.com/introduction.md): Billing infrastructure for usage-based pricing - [Quickstart](https://docs.trygrant.com/quickstart.md): Send your first event and create an invoice in under 5 minutes - [Credit packs](https://docs.trygrant.com/credit-packs-guide.md): Offer one-time credit purchases to subscribed customers - [Subscription checkout](https://docs.trygrant.com/subscription-checkout-guide.md): Send a customer to a hosted page to start or change a subscription - [Authentication](https://docs.trygrant.com/api-reference/authentication.md): Secure your API requests with bearer token authentication ## API Docs - Grant Events API > Customers [List customers](https://docs.trygrant.com/api-reference/grant-events-api/customers/list.md) - Grant Events API > Customers [Create a customer](https://docs.trygrant.com/api-reference/grant-events-api/customers/create.md) - Grant Events API > Customers [Search customers](https://docs.trygrant.com/api-reference/grant-events-api/customers/search.md) - Grant Events API > Customers [Retrieve a customer](https://docs.trygrant.com/api-reference/grant-events-api/customers/get.md) - Grant Events API > Customers [Update a customer](https://docs.trygrant.com/api-reference/grant-events-api/customers/update.md) - Grant Events API > Customers [Delete a customer](https://docs.trygrant.com/api-reference/grant-events-api/customers/delete.md) - Grant Events API > Customers [Create a customer portal link](https://docs.trygrant.com/api-reference/grant-events-api/customers/create-portal-link.md) - Grant Events API > Customers [List customer balances](https://docs.trygrant.com/api-reference/grant-events-api/customers/list-balances.md) - Grant Events API > Events [Synchronously ingest billable events](https://docs.trygrant.com/api-reference/grant-events-api/events/ingest.md) - Grant Events API > Subscriptions [List subscriptions](https://docs.trygrant.com/api-reference/grant-events-api/subscriptions/list.md) - Grant Events API > Subscriptions [Create a subscription](https://docs.trygrant.com/api-reference/grant-events-api/subscriptions/create.md) - Grant Events API > Subscriptions [Retrieve a subscription](https://docs.trygrant.com/api-reference/grant-events-api/subscriptions/get.md) - Grant Events API > Subscriptions [Update a subscription](https://docs.trygrant.com/api-reference/grant-events-api/subscriptions/update.md) - Grant Events API > Subscriptions [Cancel a subscription](https://docs.trygrant.com/api-reference/grant-events-api/subscriptions/cancel.md) - Grant Events API > Subscriptions [Change subscription plan](https://docs.trygrant.com/api-reference/grant-events-api/subscriptions/change-plan.md) - Grant Events API > Subscriptions [Create a credit grant on a subscription](https://docs.trygrant.com/api-reference/grant-events-api/subscriptions/create-credit-grant.md) - Grant Events API > Invoices [List invoices](https://docs.trygrant.com/api-reference/grant-events-api/invoices/list.md) - Grant Events API > Invoices [Retrieve an invoice](https://docs.trygrant.com/api-reference/grant-events-api/invoices/get.md) - Grant Events API > Plans [List plans](https://docs.trygrant.com/api-reference/grant-events-api/plans/list.md) - Grant Events API > Plans [Create a plan](https://docs.trygrant.com/api-reference/grant-events-api/plans/create.md) - Grant Events API > Plans [Retrieve a plan](https://docs.trygrant.com/api-reference/grant-events-api/plans/get.md) - Grant Events API > Plans [Update a plan](https://docs.trygrant.com/api-reference/grant-events-api/plans/update.md) - Grant Events API > Plans [Delete a plan](https://docs.trygrant.com/api-reference/grant-events-api/plans/delete.md) - Grant Events API > Plan fees [List plan fees](https://docs.trygrant.com/api-reference/grant-events-api/plan-fees/list-fees.md) - Grant Events API > Plan fees [Add a fee to a plan](https://docs.trygrant.com/api-reference/grant-events-api/plan-fees/create-fee.md) - Grant Events API > Plan fees [Retrieve a plan fee](https://docs.trygrant.com/api-reference/grant-events-api/plan-fees/get-fee.md) - Grant Events API > Plan fees [Update a plan fee](https://docs.trygrant.com/api-reference/grant-events-api/plan-fees/update-fee.md) - Grant Events API > Plan fees [Remove a fee from a plan](https://docs.trygrant.com/api-reference/grant-events-api/plan-fees/delete-fee.md) - Grant Events API > Plan catalogs [List catalogs attached to a plan](https://docs.trygrant.com/api-reference/grant-events-api/plan-catalogs/list-catalogs.md) - Grant Events API > Plan catalogs [Attach a catalog to a plan](https://docs.trygrant.com/api-reference/grant-events-api/plan-catalogs/attach-catalog.md) - Grant Events API > Plan catalogs [Update catalog pricing on a plan](https://docs.trygrant.com/api-reference/grant-events-api/plan-catalogs/update-catalog.md) - Grant Events API > Plan catalogs [Detach a catalog from a plan](https://docs.trygrant.com/api-reference/grant-events-api/plan-catalogs/detach-catalog.md) - Grant Events API > Plan credit grant policies [List credit grant policies](https://docs.trygrant.com/api-reference/grant-events-api/plan-credit-grant-policies/list-credit-grant-policies.md) - Grant Events API > Plan credit grant policies [Create a credit grant policy](https://docs.trygrant.com/api-reference/grant-events-api/plan-credit-grant-policies/create-credit-grant-policy.md) - Grant Events API > Plan credit grant policies [Update a credit grant policy](https://docs.trygrant.com/api-reference/grant-events-api/plan-credit-grant-policies/update-credit-grant-policy.md) - Grant Events API > Plan credit grant policies [Delete a credit grant policy](https://docs.trygrant.com/api-reference/grant-events-api/plan-credit-grant-policies/delete-credit-grant-policy.md) - Grant Events API > Credit packs [List credit packs](https://docs.trygrant.com/api-reference/grant-events-api/credit-packs/list.md) - Grant Events API > Credit packs [Retrieve a credit pack](https://docs.trygrant.com/api-reference/grant-events-api/credit-packs/get.md) - Grant Events API > Credit packs [Create a credit pack checkout link](https://docs.trygrant.com/api-reference/grant-events-api/credit-packs/create-checkout-link.md) - Grant Events API > Pricing units [List pricing units](https://docs.trygrant.com/api-reference/grant-events-api/pricing-units/list.md) - Grant Events API > Pricing units [Create a pricing unit](https://docs.trygrant.com/api-reference/grant-events-api/pricing-units/create.md) - Grant Events API > Pricing units [Retrieve a pricing unit](https://docs.trygrant.com/api-reference/grant-events-api/pricing-units/get.md) - Grant Events API > Pricing units [Update a pricing unit](https://docs.trygrant.com/api-reference/grant-events-api/pricing-units/update.md) - Grant Events API > Pricing units [Delete a pricing unit](https://docs.trygrant.com/api-reference/grant-events-api/pricing-units/delete.md) - Grant Events API > Pricing unit conversion rates [Create a pricing unit conversion rate](https://docs.trygrant.com/api-reference/grant-events-api/pricing-unit-conversion-rates/create-conversion-rate.md) - Grant Events API > Pricing unit conversion rates [Update a pricing unit conversion rate](https://docs.trygrant.com/api-reference/grant-events-api/pricing-unit-conversion-rates/update-conversion-rate.md) - Grant Events API > Pricing unit conversion rates [Delete a pricing unit conversion rate](https://docs.trygrant.com/api-reference/grant-events-api/pricing-unit-conversion-rates/delete-conversion-rate.md) - Grant Events API > Catalogs [List available pricing catalogs](https://docs.trygrant.com/api-reference/grant-events-api/catalogs/list.md) - Grant Events API > Catalogs [List catalog entries](https://docs.trygrant.com/api-reference/grant-events-api/catalogs/list-entries.md) - Grant Events API > Subscription Signup Links [Create a subscription signup link](https://docs.trygrant.com/api-reference/grant-events-api/subscription-signup-links/create.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://docs.trygrant.com/openapi.json) - [OpenAPI YAML](https://docs.trygrant.com/openapi.yaml)