# Granite Billing API

**Canonical:** https://apis.io/apis/granite-md/granite-md-billing-api/  
**Provider:** Granite — https://apis.io/providers/granite-md/  
**Base URL:** https://api.granite.md  
**Documentation:** https://docs.granite.md/

Granite Billing API is one of 19 APIs that [Granite](https://apis.io/providers/granite-md/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Billing. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Plans and payments (PLAN.md 1.2, Phase 7). A person buys Pro, with its first 30 days free once per person; a workspace buys Business per seat (members above Guest, at least 2) after its 30-day trial. Payments run through Stripe Checkout and Stripe's customer portal. A failed payment keeps the plan for 7 days; after that, or when a subscription ends, the owner is on Free's limits: nothing is deleted, but uploads over the quota are refused. Pass `workspace_id` for a workspace's billing (its owner and admins only).

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/billing` | Plan, subscription, and storage use |
| POST | `/v1/billing/checkout` | Buy Pro or Business |
| POST | `/v1/billing/portal` | Manage payment method, invoices, and cancelation |
| POST | `/v1/billing/app-store` | Record a Pro purchase made in the iPhone or iPad app |
| POST | `/v1/billing/google-play` | Record a Pro purchase made in the Android app |
| GET | `/v1/billing/invoices` | Latest invoices |
| GET | `/v1/billing/payment-methods` | Saved cards |
| POST | `/v1/billing/payment-methods` | Add a card |
| DELETE | `/v1/billing/payment-methods/{payment_method_id}` | Remove a card |
| POST | `/v1/billing/payment-methods/{payment_method_id}/default` | Pay with this card |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/granite-md/openapi/granite-md-billing-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/granite-md/json-schema/granite-md-billing-status-schema.json

## Other Granite APIs (12)

- [Granite Auth API](https://apis.io/apis/granite-md/granite-md-auth-api/)
- [Granite Comments API](https://apis.io/apis/granite-md/granite-md-comments-api/)
- [Granite Drive API](https://apis.io/apis/granite-md/granite-md-drive-api/)
- [Granite Folders API](https://apis.io/apis/granite-md/granite-md-folders-api/)
- [Granite knowledge base API](https://apis.io/apis/granite-md/granite-md-knowledge-base-api/)
- [Granite Me API](https://apis.io/apis/granite-md/granite-md-me-api/)
- [Granite Meta API](https://apis.io/apis/granite-md/granite-md-meta-api/)
- [Granite Note Shares API](https://apis.io/apis/granite-md/granite-md-note-shares-api/)
- [Granite Notes API](https://apis.io/apis/granite-md/granite-md-notes-api/)
- [Granite OAuth API](https://apis.io/apis/granite-md/granite-md-oauth-api/)
- [Granite Publish API](https://apis.io/apis/granite-md/granite-md-publish-api/)
- [Granite Search API](https://apis.io/apis/granite-md/granite-md-search-api/)

## Tags

Billing

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/granite-md/granite-md-billing-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/granite-md/.