List
Read live records straight from the Orb API.
Send Orb subscriptions, plans and customers to any warehouse, lake or AI app.
Source
Orb

Overview
The Airbyte Orb connector extracts data from Orb and loads it into 50+ destinations such as Snowflake, BigQuery, Databricks or Postgres, with full refresh and incremental sync. It publishes 5 streams you can select per connection.
Land 5 Orb tables in 50+ destinations on a schedule you control.
Query synced Orb data with filters, sorting and semantic search, without spending Orb API rate limits.
Pull only the records that changed since the last run instead of reloading everything.
Authenticate Orb once. The same connection powers scheduled syncs and runtime actions.
5 streams
| Sync modes | FullIncr. |
|---|
| Sync modes | FullIncr. |
|---|
| Sync modes | FullIncr. |
|---|
| Sync modes | FullIncr. |
|---|
| Sync modes | FullIncr. |
|---|
Setup
First, navigate to the Orb source connector page on Airbyte.com.
Click on the "Add Source" button to begin the process of adding your Orb source connector.
Select the Orb source connector from the list of available connectors.
Enter the necessary credentials for your Orb source connector, including the API key and any other required information.
Once you have entered your credentials, click on the "Test" button to ensure that your connection is working properly.
If the test is successful, click on the "Save" button to save your Orb source connector settings.
You can now use your Orb source connector to import data into Airbyte and begin using it for your data integration needs. It is important to note that the specific steps for connecting your Orb source connector may vary depending on your specific use case and the requirements of your data integration project. For more detailed information on how to connect your Orb source connector on Airbyte.com, please refer to the documentation provided on the Airbyte website.
| Field | Type | Description |
|---|---|---|
| api_key* | string | Orb API Key, issued from the Orb admin console. |
| start_date* | string | UTC date and time in the format 2022-03-01T00:00:00Z. Any data with created_at before this data will not be synced. For Subscription Usage, this becomes the timeframe_start API parameter. |
| end_date | string | UTC date and time in the format 2022-03-01T00:00:00Z. Any data with created_at after this data will not be synced. For Subscription Usage, this becomes the timeframe_start API parameter. |
| lookback_window_days | integer | When set to N, the connector will always refresh resources created within the past N days. By default, updated objects that are not newly created are not incrementally synced. |
| numeric_event_properties_keys | array | Property key names to extract from all events, in order to enrich ledger entries corresponding to an event deduction. |
| plan_id | string | Orb Plan ID to filter subscriptions that should have usage fetched. |
| string_event_properties_keys | array | Property key names to extract from all events, in order to enrich ledger entries corresponding to an event deduction. |
| subscription_usage_grouping_key | string | Property key name to group subscription usage by. |
4 actions
Read live records straight from the Orb API.
Fetch a single record by ID.
Query synced data with filters and sorting, with no API rate limits.
Natural-language search across synced Orb records.
Full parameter-level details live in the Orb entity reference.
Hybrid deployment
The data plane runs in your environment. Records, credentials and keys stay with you; the control plane only receives configuration and job metadata.
Your environment
Airbyte control plane
Use cases
Show me all my customers in Orb
Show me details for a recent customer
List all active subscriptions
What is the status of a recent subscription?
Show me the details of the most recent subscription
What plans are available?
Show me the pricing details for a plan
Show me recent invoices
Confirm the Stripe ID linked to a customer
What is the payment provider ID for a customer?
List all invoices for a specific customer
List all subscriptions for customer XYZ
Show all active subscriptions for a specific customer
What subscriptions does customer external_customer_id have?
Pull all invoices from the last month
Show invoices created after date
List all paid invoices for customer customer_id
What invoices are in draft status?
Show all issued invoices for subscription subscription_id
FAQ
No. One Orb authorization powers both the scheduled syncs that land data in your destination and the entity actions your agents call at runtime.
No. Entity actions read and write through the Orb API as they are called, so they work immediately. Context store search is the exception: it queries data Airbyte has already synced, which is what lets it filter and sort without spending API rate limits.
5 streams: Subscriptions, Plans, Customers, Credits Ledger Entries, Subscription Usage.
Yes. The Orb connector supports incremental sync on selected streams, and full refresh on every stream.
Run the Orb connector on Cloud, OSS, Hybrid. Hybrid deployments keep the data plane in your environment while the control plane orchestrates syncs.
Didn't find your answer? Talk to sales
Free 14-day trial. One connection powers your scheduled syncs and your live Orb actions.