# Orb (slim)

> Orb is a hosted billing platform for usage-based, seat-based and hybrid pricing. It ingests usage events, computes metrics, and runs plans, subscriptions, prepaid credits and invoices through a REST API with SDKs in six languages.

- Full: https://www.anchorterminal.com/tools/orb.md (~8,350 tokens) · this version ~2,130 tokens · JSON https://www.anchorterminal.com/tools/orb.json · canonical https://www.anchorterminal.com/tools/orb
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-10

**B · 66.5/100 · rank #289 of 950 · #7 in Payment & monetisation platforms · not agent-ready · confidence medium**


Assessment: Orb suits a company that bills on usage and wants one API for events, plans, credits and invoices. It publishes an OpenAPI 3.1 file, numeric rate limits, idempotency keys and a dry-run header. Every plan is priced on request and access starts with sales. No scope list for API keys or public sub-processor list was found.

## Facts

- Kind: HTTP API · vendor: Orb, Inc. · category: Payment & monetisation platforms · legal entity: Orb, Inc. · provenance 84/100
- Endpoint: `https://api.withorb.com/v1` (HTTP)
- Auth: API key · pricing: Paid · x402: no · licence: Proprietary service under Orb's Platform Terms and Conditions. The SDKs on GitHub are Apache-2.0
- Probe metrics: not measured yet (probes haven't run)
- API: REST at `https://api.withorb.com/v1`. The OpenAPI 3.1 description (version 1.0) has 147 operations on 115 paths, 729 schemas and 79 webhook events, across customers, events, metrics, plans, prices, subscriptions, invoices, credit notes, credits, coupons, alerts and items
- Credentials: API key as a Bearer token, created in the web app under organisation settings, separately for test mode and live mode. Revocation is irreversible. No scope list was found. Dashboard users are Admin, Editor or Viewer, with password, Google, Microsoft or SAML sign-in
- Rate limits: Live mode, per second, 10 analytics queries, 10 ledger queries, 100 other reads, 50 writes and 100 ingestion requests, with 10,000 ingested events a minute by default. Test mode 5, 5, 50, 5 and 10, with 2,000 events a minute. Trial 1, 1, 10, 1 and 2, with 100 events a minute
- Retries: `Idempotency-Key` on POST and PATCH, up to 64 characters, kept 48 hours. `Idempotent-Replayed: true` on a replay, 409 on a concurrent or changed retry, `Transient-Error: true` on retryable 500s. Each usage event carries its own `idempotency_key`. Exponential backoff advised on 429, with no `Retry-After` documented
- Dry run: `Dry-Run: True` request header on most writes, confirmed by `Orb-Dry-Run: true` in the response. Not supported on ingest, amend event and deprecate event
- Errors: RFC 7807 bodies with `status`, `title`, `type` and `detail`. Nine documented types across 400, 401, 404, 409, 429 and 500, each with a stable `type` URI, and a `validation_errors` array on 400
- Pagination: Cursor-based. `limit` defaults to 20 with a maximum of 100, and responses carry `pagination_metadata` with `has_more` and `next_cursor`. List calls filter on dates and amounts with `[gt]`, `[gte]`, `[lt]` and `[lte]` suffixes
- SDKs: Python `orb-billing` 4.83.0, TypeScript `orb-billing` 6.27.0 and Go `orb-go` v1.126.0, all tagged 9 October 2026, plus Java, Kotlin and Ruby. Generated by Stainless under Apache-2.0. The Python SDK retries twice by default on connection errors, 408, 409, 429 and 5xx
- Webhooks: 79 event types in the API description. Signed with HMAC-SHA256 in `X-Orb-Signature` over `v1:`, the `X-Orb-Timestamp` value and the body, one secret per endpoint. At-least-once delivery, a five-second response window and a retry schedule that starts at 5 seconds, 5 minutes, 30 minutes and 2 hours
- Payment collection: Invoices are collected through connected Stripe or Adyen accounts, with dunning. Stripe Shared Payment Tokens for agent-granted payment are supported on request. Invoicing and accounting sync to QuickBooks, NetSuite and Bill.com, and tax through Anrok, Avalara, Numeral, Sphere, Stripe Tax or TaxJar
- Plans: Core, Advanced and Enterprise, each at custom pricing based on billings and ingested events, with a platform fee on Advanced and Enterprise. The terms describe a 30-day free trial that Orb may grant. SLAs are listed for Enterprise only, in the customer's agreement
- Audit: Audit logs record the action, time, actor (API key or user), targets, IP address and user agent, without request bodies, and can stream to a SIEM. Private preview, Enterprise plan only
- Certifications: SOC 2 Type 2 and SOC 1 Type 2 per the trust centre, an annual third-party penetration test, and a disclosure policy with security@withorb.com. Reports and the DPA need an access request
- Status: status.withorb.com on Atlassian Statuspage with eight components (API, Reads, Writes, Analytics, Ingest, Real-time alerting, Webhooks, Invoicing) and 90-day uptime bars. Dedicated enterprise deployments are not covered

- Scores: Reliability 77, Performance pending, Schema & documentation 88, Agent ergonomics 84, Security & auth 55, Payments & pricing 5, Task success pending, Maintenance & community 82, Transparency & trust 65 · total over the 7 assessed categories
- Why: Reliability, Hosted lines. · Schema & documentation, A public OpenAPI 3.1 description with 147 operations, 729 schemas and 79 webhook events (25). · Agent ergonomics, Graded on the REST API. · Security & auth, API keys are Bearer tokens created in the web app, separately for test mode and live mode, and can be revoked. · Payments & pricing, Payment platforms take the highest step that applies on the 40-point protocol line. · Maintenance & community, The Python SDK 4.83.0, TypeScript SDK 6.27.0 and Go SDK v1.126.0 were all tagged on 9 October 2026, the day of the check (30). · Transparency & trust, The platform is closed under published Platform Terms and Conditions, and the SDKs are Apache-2.0. The terms page shows no version date (17…
- Sources: 32, open questions: 13, both in the full twin
- Capabilities: payments.metering, payments.card
- JSON: https://www.anchorterminal.com/api/v1/tools/orb.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/orb.svg` or a link to https://www.anchorterminal.com/tools/orb from a page on withorb.com or one of its subdomains, or the README of github.com/orbcorp/orb-python, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Call `https://api.withorb.com/v1` with `Authorization: Bearer <key>`. A person creates the key in the Orb web app under organisation settings, in test mode or live mode
2. Send an `Idempotency-Key` of at most 64 characters on every POST and PATCH. A 409 means the first request is still running or the body changed
3. Add `Dry-Run: True` to check a write first, and confirm `Orb-Dry-Run: true` in the response. Ingest, amend and deprecate event calls ignore it and run for real
4. Do not send `Idempotency-Key` with `Dry-Run`. Orb returns a validation error
5. Page with `limit` (default 20, maximum 100) and pass `next_cursor` back as `cursor` while `has_more` is true
6. Back off exponentially on 429. Test mode allows 5 writes a second and 2,000 ingested events a minute

## Connect

```bash
pip install orb-billing
```

```bash
curl --request POST \
     --url https://api.withorb.com/v1/subscriptions \
     --header 'Dry-Run: True' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer <TOKEN>' \
     --header 'Content-Type: application/json'
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/orb

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Stripe API + MCP | A | 82.4 | payments.card, payments.metering | https://www.anchorterminal.com/tools/stripe-mcp.min.md |
| Nevermined API + MCP | BB | 70.8 | payments.card, payments.metering | https://www.anchorterminal.com/tools/nevermined.min.md |
| Lago | B | 65.7 | payments.metering, payments.card | https://www.anchorterminal.com/tools/lago.min.md |
| Paid | C | 55.1 | payments.metering, payments.card | https://www.anchorterminal.com/tools/paid.min.md |
| ATXP | E | 42.9 | payments.metering, payments.card | https://www.anchorterminal.com/tools/atxp.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)