> ## 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. # Get the ARR bridge > Returns contracted MRR month by month with its movements (opening, new, reactivation, expansion, contraction, churn, closing), ARR, net and gross revenue retention, active customers and ACV. Amounts are in the organization's reporting currency, converted at one fixed rate per currency for every month, so exchange movements never show as expansion or contraction. ## OpenAPI ````yaml /api-reference/v2/specs/2026-04-01.json get /insights/arr-bridge 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: get: tags: - Insights summary: Get the ARR bridge description: >- Returns contracted MRR month by month with its movements (opening, new, reactivation, expansion, contraction, churn, closing), ARR, net and gross revenue retention, active customers and ACV. Amounts are in the organization's reporting currency, converted at one fixed rate per currency for every month, so exchange movements never show as expansion or contraction. operationId: get-arr-bridge parameters: - in: header name: Alguna-Version required: true schema: enum: - '2026-04-01' type: string - in: query name: from required: true schema: description: First month reported, as YYYY-MM example: 2025-01 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/ARRBridgeResponse' 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: ARRBridgeResponse: properties: basis: description: >- contracted reports the full contracted rate; cash subtracts fixed-term discounts and free periods while they last enum: - contracted - cash example: contracted type: string currency: description: ISO 4217 currency every amount is reported in example: USD type: string months: description: Chronologically ordered months items: $ref: '#/components/schemas/ARRBridgeMonth' type: array rates: description: The fixed rate applied to each subscription currency in every month items: $ref: '#/components/schemas/ARRBridgeRate' type: array required: - basis - currency - months - rates 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 ARRBridgeMonth: properties: active_customers: description: Customers with MRR at month end example: 120 format: int64 type: integer arr: description: 12 × closing MRR example: '1266000.00' type: string arr_change: description: 12 × the change in MRR example: '66000.00' type: string arr_change_rolling_3_month: description: Monthly ARR change summed over this month and the two before example: '150000.00' type: string average_acv: description: 12 × the average MRR of active customers example: '10550.00' type: string churn_mrr: description: MRR lost by customers who leave example: '2000.00' type: string closing_mrr: description: >- Opening plus new, reactivation and expansion, less contraction and churn example: '105500.00' type: string contraction_mrr: description: MRR lost by customers who stay example: '1500.00' type: string expansion_mrr: description: MRR added by existing customers example: '3000.00' type: string grr: description: >- MRR now of the customers of twelve months ago, each capped at their MRR then, over their MRR then example: '0.92' nullable: true type: string month: description: First day of the month; amounts are as at its end example: '2026-01-01T00:00:00Z' format: date-time type: string monthly_growth: description: >- Change in MRR as a fraction of opening MRR; null when it opened at zero example: '0.055' nullable: true type: string monthly_nrr: description: >- MRR now from last month's customers over last month's MRR; null without any example: '1.02' nullable: true type: string new_customer_acv: description: >- Average ACV of the customers in their first month; 0 when none started example: '15000.00' type: string new_customers: description: Customers in their first month example: 4 format: int64 type: integer new_mrr: description: MRR from customers in their first month example: '5000.00' type: string opening_mrr: description: Contracted MRR at the end of the month before example: '100000.00' type: string reactivation_mrr: description: MRR from customers returning after a month without any example: '1000.00' type: string yearly_nrr: description: >- MRR now from the customers of twelve months ago over their MRR then; null without that history example: '1.1' nullable: true type: string required: - active_customers - arr - arr_change - arr_change_rolling_3_month - average_acv - churn_mrr - closing_mrr - contraction_mrr - expansion_mrr - month - new_customer_acv - new_customers - new_mrr - opening_mrr - reactivation_mrr type: object ARRBridgeRate: properties: currency: description: ISO 4217 currency converted from example: EUR type: string rate: description: Units of the reporting currency per unit of currency example: '1.135' type: string required: - currency - rate 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.