> ## Documentation Index > Fetch the complete documentation index at: https://alguna.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List ARR bridge rows > Lists the customers behind the ARR bridge with their MRR, change and movement for each month, contracted and cash ACV, and billed to date. Pass customer_id to drill into that customer's subscriptions, or subscription_id for that subscription's products; each level's changes sum to the row above it. ## OpenAPI ````yaml /api-reference/v2/specs/2026-04-01.json get /insights/arr-bridge/rows openapi: 3.1.0 info: title: Alguna Public API version: '2026-04-01' servers: - url: https://api.alguna.io x-fern-server-name: Production security: - bearerAuth: [] tags: - name: Billing Events and Metrics - name: Checkout Sessions - name: Credit Notes - name: Credits - name: Customer Portal Sessions - name: Customers - name: Feedback - name: Insights - name: Integrations - name: Invoices - name: Merchants - name: Payments - name: Plans - name: Product Bundles - name: Products - name: Quotes - name: Refunds - name: Revenue Schedules - name: Subscription Changes - name: Subscription Versions - name: Subscriptions - name: Tags - name: Tax - name: Users - name: Wallet Grants - name: Wallets paths: /insights/arr-bridge/rows: get: tags: - Insights summary: List ARR bridge rows description: >- Lists the customers behind the ARR bridge with their MRR, change and movement for each month, contracted and cash ACV, and billed to date. Pass customer_id to drill into that customer's subscriptions, or subscription_id for that subscription's products; each level's changes sum to the row above it. operationId: list-arr-bridge-rows parameters: - in: header name: Alguna-Version required: true schema: enum: - '2026-04-01' type: string - in: query name: customer_id schema: description: List this customer's subscriptions instead of customers example: acct_abc123 type: string - in: query name: from required: true schema: description: First month reported, as YYYY-MM example: 2025-01 type: string - in: query name: limit schema: default: 50 description: Maximum number of rows to return format: int32 maximum: 100 minimum: 1 type: integer - in: query name: offset schema: default: 0 description: Number of rows to skip format: int32 minimum: 0 type: integer - in: query name: subscription_id schema: description: List this subscription's products instead of customers example: sub_abc123 type: string - in: query name: to required: true schema: description: Last month reported, as YYYY-MM example: 2025-12 type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ARRBridgeRowListResponse' description: Success '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad Request '401': content: application/json: schema: oneOf: - $ref: '#/components/schemas/ErrorResponse' - $ref: '#/components/schemas/GatewayErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Forbidden — the organization does not have access to this feature '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal Server Error '502': description: >- Bad Gateway — sent by the infrastructure in front of the API; the body is not JSON. Safe to retry. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Service Unavailable — a dependency is temporarily unavailable. Retry with backoff. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Gateway Timeout — the request did not finish in time. Retry with backoff; use an idempotency key for writes. components: schemas: ARRBridgeRowListResponse: properties: data: description: Rows of the requested level items: $ref: '#/components/schemas/ARRBridgeRow' type: array pagination: $ref: '#/components/schemas/PaginationMeta' required: - data - pagination type: object ErrorResponse: description: The body of every error the API returns. properties: detail: description: Explanation of what went wrong type: string status: description: HTTP status code of the response format: int64 type: integer title: description: >- HTTP status text. Sent only by version, idempotency and credit-refusal errors. type: string type: description: Always `about:blank`. Sent only by version and idempotency errors. type: string required: - status - detail type: object GatewayErrorResponse: description: >- Returned by the API gateway when a request carries no valid API key, before the API handles it. properties: code: description: Machine-readable error code, e.g. `unauthenticated` type: string details: nullable: true type: object message: description: Explanation of what went wrong type: string required: - code - message type: object ARRBridgeRow: properties: billed_to_date: description: >- Invoiced before tax up to the end of the last month; null on product rows example: '95000.00' nullable: true type: string cash_acv: description: 12 × the last month's MRR on the cash basis example: '108000.00' type: string contracted_acv: description: 12 × the last month's MRR on the contracted basis example: '120000.00' type: string customer_id: description: Customer ID example: acct_abc123 type: string level: description: >- Customers roll up their subscriptions, and subscriptions their products enum: - customer - subscription - product example: customer type: string months: description: Chronologically ordered months items: $ref: '#/components/schemas/ARRBridgeRowMonth' type: array name: description: Customer, subscription or product name example: Acme Corp type: string product_id: description: >- Product ID on product rows; empty for contract-level amounts no product carries example: prod_abc123 nullable: true type: string subscription_id: description: Subscription ID on subscription and product rows example: sub_abc123 nullable: true type: string required: - cash_acv - contracted_acv - customer_id - level - months - name type: object PaginationMeta: properties: per_page: description: Number of items returned per page example: 20 format: int64 type: integer total_pages: description: Total number of pages available example: 5 format: int64 type: integer required: - per_page - total_pages type: object ARRBridgeRowMonth: properties: change: description: Change from the month before; a row's changes sum to its parent's example: '500.00' type: string month: description: First day of the month example: '2026-01-01T00:00:00Z' format: date-time type: string movement: description: How the month compares with the one before enum: - new - reactivation - expansion - contraction - churn - flat example: expansion type: string mrr: description: MRR at month end example: '10000.00' type: string units: description: >- Quantity in force on product rows, when the product's prices carry one example: 70 format: int64 nullable: true type: integer required: - change - month - movement - mrr type: object securitySchemes: bearerAuth: bearerFormat: API Key description: API key authentication. Pass your API key as a Bearer token. scheme: bearer type: http x-fern-bearer: env: ALGUNA_API_KEY name: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.