Overview
You can export a wide range of data from the Subi Export Builder, including information about your subscriptions, customers, orders, and billing attempts. This article lists every export option currently available and describes the contents of each file. New export types will be added as they become available.
What subscription contract exports are available?
You can export detailed data about your subscription contracts managed within Subi. The following contract types can be exported as .csv
files:
All contracts
Active contracts
Cancelled contracts
Expired contracts
Paused contracts
Each row in the export represents a line item, so contracts with multiple items will have a row for each item.
Note: In these exports, each row details the price and quantity of a single line item in a contract. If a contract includes multiple items, each item appears as a separate row.
In the exported file, you’ll see columns such as:
Column Header | Description | Data Format/Type |
| A globally unique identifier for the subscription contract. | Numeric ID |
| The date and time when the subscription contract was created. | ISO 8601 DateTime |
| The current status of the subscription contract (e.g., | Text |
| The date of the next scheduled billing for the contract. | ISO 8601 DateTime |
| The number of unique items (lines) in the contract. | Integer |
| The price for delivery, including | JSON Object |
| JSON object describing billing intervals, max cycles, and minimum cycles. | JSON Object |
| JSON object describing delivery intervals and counts. | JSON Object |
| JSON object containing delivery method details, including address information. | JSON Object |
| Status of the last payment (e.g., | Text or Null |
| The index of the upcoming billing cycle. | Integer |
| The initial price of the subscription contract. | Decimal |
| The ID of the order from which the contract originated. | Numeric ID or Null |
| The ISO 4217 currency code for all monetary values (e.g., | Text |
| An optional note associated with the contract that will be applied to the generated orders. | Text or Null |
| A JSON array of discounts applied to the contract. | JSON Array |
| The unique identifier for the customer associated with the contract. | Numeric ID |
| The billing interval for the contract (e.g., | Text |
| The number of intervals between billings. | Integer |
| The delivery interval for the contract (e.g., | Text |
| The number of intervals between deliveries. | Integer |
| The type of delivery method for the contract (e.g., | Text |
| Details about the delivery address (e.g., | Text or Null |
| Payment method details, including instrument type and revocation info. | Text or Null |
| Details about the line item, such as product title, variant, pricing, and quantity. | Varies |
| The image URL of the variant for the line item. | URL |
| The unique identifier for the selling plan associated with the line. | Numeric ID |
| The name of the selling plan associated with the line (e.g., " | Text |
| JSON object describing base price and pricing policies. | JSON Object |
| The base price amount for the line item. | Decimal |
| The currency code for the line item base price (e.g., | Text |
| A JSON array detailing any discounts applied to the line. | JSON Array |
What is included in the Subscription Contracts: Changes Log (Events) export?
The Changes Log (Events) export provides a log of changes made to your subscription contracts, tracking events such as contract creation, updates, cancellations, and status changes.
Key columns you’ll find:
Column Header | Description | Data Format/Type |
| A globally unique identifier for the event log. | Numeric ID |
| The unique identifier of the subscription contract associated with the event. | Numeric ID |
| The date and time when the event was created (e.g., | ISO 8601 DateTime |
| The severity or type of log message (e.g., | Text |
| The entity responsible for the action (e.g., | Text |
| A label describing the type of event (e.g., | Text |
| Additional details about the event, often including the status of the subscription contract or any changes. | JSON object or Text |
| A user-friendly message describing the event, such as " | Text |
What does the Customers export include?
The Customers export provides details about your customers and their current subscription status.
Column definitions:
|
|
|
| A globally unique identifier for the customer. | Numeric ID |
| The customer's first name, if provided. | Text (nullable) |
| The customer's last name, if provided. | Text (nullable) |
| The customer's email address. | Text |
| The current account state of the customer (e.g., | Text |
| The language and regional locale of the customer (e.g., | Text |
What is included in the Orders export?
The Orders export contains details about orders created through Subi, including their current status, pricing, and fulfillment details.
Column definitions:
|
|
|
| A globally unique identifier for the order. | Numeric ID |
| The name or number of the order, typically prefixed by a hash (e.g., | Text |
| The unique identifier of the associated subscription contract. | Numeric ID |
| The date and time when the order was created. | ISO 8601 DateTime |
| The date and time when the order was canceled, if applicable. | ISO 8601 DateTime (nullable) |
| Indicates whether the order is closed ( | Boolean |
| The date and time when the order was closed, if applicable. | ISO 8601 DateTime (nullable) |
| Indicates whether the order is fully paid ( | Boolean |
| The current fulfillment status of the order (e.g., | Text |
| The current financial status of the order (e.g., | Text |
| The subtotal price for the order, excluding taxes (e.g., | Decimal |
| The total price for the order, including taxes (e.g., | Decimal |
| The total amount of tax for the order (e.g., | Decimal |
| Indicates whether taxes are included in the order’s total price ( | Boolean |
What can I export with the Billing Attempts export?
The Billing Attempts export shows every attempt to bill a customer for a subscription contract, including the status, errors, and result.
Column definitions:
|
|
|
| A globally unique identifier for the billing attempt. | Numeric ID |
| Unique identifier of the associated subscription contract. | Numeric ID |
| The date and time when the billing attempt was initiated. | ISO 8601 DateTime |
| The date and time when the billing attempt was completed. | ISO 8601 DateTime (nullable) |
| The error code for a failed billing attempt. Common values include | Text (nullable) |
| A descriptive message detailing any payment error that occurred during processing. | Text (nullable) |
| The unique key generated by the client for the billing attempt to prevent duplicate payments. | Text |
| The URL where the customer needs to be redirected to complete actions like 3D Secure payment flows, if applicable. | Text (nullable) |
| Indicates whether the billing attempt is still processing ( | Boolean |
| Unique identifier for the order resulting from a successful billing attempt. | Numeric ID |
These descriptions align with the definitions provided in the Shopify API documentation. For more technical details, refer to the Shopify GraphQL Admin API documentation.
This article lists all export types currently available in Subi. If you have suggestions for additional export types, let us know!
Next Steps
For more information about managing exports and working with your data, see these related articles:
How do I export data from Subi?
Step-by-step instructions to start and download exports.Using the Export Builder in Subi
Export and analyze your subscription data with ease using Subi Export Builder.
Need Help?
Feel free to contact our support team. We're here for you anytime:
Live Chat: Message us from within the Subi app or your Shopify Admin.
Email: Reach us at support@subi.co.