> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recurso.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Plans Pricing on a Metric

> The charges that consume a billable metric, each with its plan and charge model — the reverse lookup of a plan's charges.

Returns the charges that consume this billable metric, each with its plan
(name, code, active flag) and charge model — the meter page's "which plans
price on this meter", the reverse of a plan's charges. Use it before
[deleting](/api-reference/metrics/delete) or reshaping a metric to see what
pricing depends on it.

## Example Request

```bash theme={null}
curl "https://api.recurso.dev/v1/billable-metrics/3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f/charges" \
  -H "Authorization: Bearer $API_KEY"
```

## Response

```json theme={null}
{
  "data": [
    {
      "charge_id": "9f8e7d6c-5b4a-4938-8271-605f4e3d2c1b",
      "plan_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "plan_name": "Growth",
      "plan_code": "growth-monthly",
      "plan_active": true,
      "charge_model": "graduated",
      "pay_in_advance": false
    },
    {
      "charge_id": "7e9f0a1b-2c3d-4e5f-8a6b-7c8d9e0f1a2b",
      "plan_id": "5c7d8e9f-0a1b-4c2d-8e3f-4a5b6c7d8e9f",
      "plan_name": "Scale",
      "plan_code": "scale-monthly",
      "plan_active": true,
      "charge_model": "package",
      "pay_in_advance": true
    }
  ]
}
```

## Fields

| Field                                 | Type                   | Description                                                           |
| ------------------------------------- | ---------------------- | --------------------------------------------------------------------- |
| `charge_id`                           | string (uuid)          | The charge on the plan                                                |
| `plan_id` / `plan_name` / `plan_code` | uuid / string / string | The plan the charge belongs to                                        |
| `plan_active`                         | boolean                | Whether that plan is currently active                                 |
| `charge_model`                        | string                 | How the charge prices usage (e.g. `standard`, `graduated`, `package`) |
| `pay_in_advance`                      | boolean                | Whether the charge bills in advance rather than in arrears            |

<Note>
  Read-only. A metric no plan prices on returns an empty list; a missing or
  cross-tenant `id` returns `404`.
</Note>


## OpenAPI

````yaml GET /v1/billable-metrics/{id}/charges
openapi: 3.1.0
info:
  title: Recurso API
  version: 1.0.0
  description: |
    The Recurso billing engine REST API.

    Authenticate by passing your API key as a bearer token:

        Authorization: Bearer <api_key>

    Obtain an API key by registering a tenant via `POST /auth/register`.
    All authenticated endpoints live under the `/v1` prefix. Mutating
    endpoints support idempotency via the `Idempotency-Key` header.
  license:
    name: MIT
    identifier: MIT
servers:
  - url: https://billing.example.com
    description: >-
      Example deployment — substitute the base URL of your own Recurso
      deployment.
security:
  - bearerAuth: []
tags:
  - name: System
    description: Health, version, and API metadata
  - name: Auth
    description: Tenant registration
  - name: Plans
    description: Product catalog plans
  - name: Customers
    description: Customer management
  - name: Subscriptions
    description: Subscription lifecycle
  - name: Invoices
    description: Invoices, PDFs, and Indian GST e-invoicing
  - name: Coupons
    description: Discounts
  - name: Usage
    description: Metered usage events
  - name: Credit Notes
    description: Customer credits
  - name: Quotes
    description: Quote-to-invoice lifecycle
  - name: Webhooks
    description: Webhook endpoint management and event feed
  - name: Analytics
    description: Revenue analytics
  - name: Checkout
    description: Public hosted checkout for invoices
  - name: Payments
    description: Payment order creation
  - name: Inbound Webhooks
    description: Receivers for payment-gateway callbacks (Razorpay, Stripe)
  - name: Customer Portal
    description: Customer-facing portal — magic-link auth and session-scoped data
  - name: Developer
    description: API key management
  - name: Account
    description: Tenant account settings
  - name: Finance
    description: Ledger accounts, entries, reconciliation, and revenue recognition
  - name: Settings
    description: Tax (GST) and e-invoicing (IRP) configuration
  - name: Consents
    description: Consent records for RBI-compliant recurring billing
  - name: Referrals
    description: Customer referral program
  - name: Gifts
    description: Gift subscriptions
  - name: Mandates
    description: UPI Autopay mandates
  - name: Offline Payments
    description: Virtual accounts and manually recorded payments
  - name: Organizations
    description: Multi-entity organizations grouping several tenants
  - name: Accounting
    description: QuickBooks / Xero accounting integrations
  - name: Churn
    description: Churn risk scoring and alerts
  - name: Cancel Flows
    description: Configurable retention flows shown at cancellation time
  - name: Dunning
    description: Dunning analytics and multi-channel dunning campaigns
paths:
  /v1/billable-metrics/{id}/charges:
    get:
      tags:
        - Metering
      summary: Plans pricing on this meter (reverse lookup)
      description: >
        The charges that consume this billable metric, each with its plan (name,
        code, active) and charge model — the meter page's "which plans price on
        this meter", the reverse of a plan's charges. Read-only.
      operationId: getMetricCharges
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: The charges consuming this metric.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        charge_id:
                          type: string
                          format: uuid
                        plan_id:
                          type: string
                          format: uuid
                        plan_name:
                          type: string
                        plan_code:
                          type: string
                        plan_active:
                          type: boolean
                        charge_model:
                          type: string
                        pay_in_advance:
                          type: boolean
        '404':
          description: Metric not found.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: >-
        Tenant API key obtained from `POST /auth/register` or `POST
        /v1/developer/keys`.

````