# Orb Event API

**Canonical:** https://apis.io/apis/orb-billing/orb-billing-event-api/  
**Provider:** Orb — https://apis.io/providers/orb-billing/  
**Base URL:** https://api.withorb.com/v1  
**Documentation:** https://docs.withorb.com/api-reference/customer

Orb Event API is one of 32 APIs that [Orb](https://apis.io/providers/orb-billing/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Event. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

The [Event](/core-concepts#event) resource represents a usage event that has been created for a customer. Events are the core of Orb's usage-based billing model, and are used to calculate the usage charges for a given billing period.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| GET | `/events/backfills` | List backfills |
| POST | `/events/backfills` | Create backfill |
| GET | `/events/backfills/{backfill_id}` | Fetch backfill |
| POST | `/events/backfills/{backfill_id}/close` | Close backfill |
| POST | `/events/backfills/{backfill_id}/revert` | Revert backfill |
| POST | `/events/search` | Search events |
| GET | `/events/volume` | Get event volume |
| PUT | `/events/{event_id}` | Amend event |
| PUT | `/events/{event_id}/deprecate` | Deprecate event |
| POST | `/ingest` | Ingest events |
| POST | `/prices/evaluate_preview_events` | Evaluate preview events |

## Machine-readable artifacts (13)

- **OpenAPI** — https://artifacts.apis.io/orb-billing/openapi/orb-billing-event-api-openapi.yml
- **APIReference** — https://docs.withorb.com/api-reference/customer
- **PostmanCollection** — https://artifacts.apis.io/orb-billing/collections/orb-billing.postman_collection.json
- **APIReference** — https://docs.withorb.com/api-reference/plan
- **APIReference** — https://docs.withorb.com/api-reference/subscription
- **Documentation** — https://docs.withorb.com/events-and-metrics/event-ingestion
- **APIReference** — https://docs.withorb.com/api-reference/event
- **Documentation** — https://docs.withorb.com/invoicing/structure
- **APIReference** — https://docs.withorb.com/api-reference/invoice
- **APIReference** — https://docs.withorb.com/api-reference/credit
- **APIReference** — https://docs.withorb.com/api-reference/price
- **APIReference** — https://docs.withorb.com/api-reference/alert
- **Documentation** — https://docs.withorb.com/guides/integrations-and-exports/webhooks

## Other Orb APIs (12)

- [Orb Alerts API](https://apis.io/apis/orb-billing/orb-billing-alerts-api/)
- [Orb Credits API](https://apis.io/apis/orb-billing/orb-billing-credits-api/)
- [Orb Events API](https://apis.io/apis/orb-billing/orb-billing-events-api/)
- [Orb Accounting sync webhooks API](https://apis.io/apis/orb-billing/orb-billing-accounting-sync-webhooks-api/)
- [Orb Alert API](https://apis.io/apis/orb-billing/orb-billing-alert-api/)
- [Orb Automation webhooks API](https://apis.io/apis/orb-billing/orb-billing-automation-webhooks-api/)
- [Orb Availability API](https://apis.io/apis/orb-billing/orb-billing-availability-api/)
- [Orb Coupon API](https://apis.io/apis/orb-billing/orb-billing-coupon-api/)
- [Orb Credit API](https://apis.io/apis/orb-billing/orb-billing-credit-api/)
- [Orb Credit note API](https://apis.io/apis/orb-billing/orb-billing-credit-note-api/)
- [Orb Customer API](https://apis.io/apis/orb-billing/orb-billing-customer-api/)
- [Orb Customer webhooks API](https://apis.io/apis/orb-billing/orb-billing-customer-webhooks-api/)

## Tags

Event

---

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