# The Rate Card Rate object

### The Rate Card Rate object

```json
{
  "id": "rcdr_test_61Rc0EwMrmxaJaSum16RM8VQESSQ4t1K5KYFAmKUSPLs",
  "object": "v2.billing.rate_card.rate",
  "metered_item": {
    "id": "blbli_test_61Rc0Ew1oiQyokWns16RM8VQESSQ4t1K5KYFAmKUSA5o",
    "object": "v2.billing.metered_item",
    "display_name": "API requests",
    "lookup_key": "api_requests",
    "unit_label": "request",
    "meter": "mtr_test_61RCjiqdTDC91zgip41IqPCzPnxqqSVc",
    "created": "2024-11-26T16:33:03.000Z",
    "livemode": false
  },
  "metadata": {},
  "rate_card": "rcd_test_61Rc0EnUkb3UIaPVQ16RM8VQESSQ4t1K5KYFAmKUSUCG",
  "rate_card_version": "rcdv_test_61Rc0EnbIs6eHyCWW16RM8VQESSQ4t1K5KYFAmKUS2Nk",
  "tiers": [],
  "unit_amount": "1000.0",
  "created": "2024-11-26T16:33:03.000Z",
  "livemode": false
}
```

## Attributes

- `id` (string)
  Unique identifier for the object.

- `object` (string, value is "v2.billing.rate_card_rate")
  String representing the object’s type. Objects of the same type share the same value of the object field.

- `created` (timestamp)
  Timestamp of when the object was created.

- `livemode` (boolean)
  Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

- `metadata` (map, nullable)
  Set of [key-value pairs](https://docs.stripe.com/api/metadata.md) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

- [`metered_item`](https://docs.stripe.com/api/v2/rate-cards/rate-card-rates/object.md?query=metered_item) (object)
  A Metered Item represents a billable item whose pricing is based on usage, measured by a meter. You can use rate cards to specify the pricing and create subscriptions to these items.

- `rate_card` (string)
  The ID of the Rate Card it belongs to.

- `rate_card_version` (string)
  The ID of the Rate Card Version it was created on.

- `tiering_mode` (enum, nullable)
  Defines whether the tiering price is graduated or volume-based. In volume-based tiering, the maximum quantity within a period determines the per-unit price. In graduated tiering, the pricing changes as the quantity grows into new tiers. Can only be set if `tiers` is set.
Possible enum values:
  - `graduated`
    Use graduated tiering: the pricing at each tier applies to the quantity within that tier.

  - `volume`
    Use volume-based tiering: the maximum quantity within a period determines the per-unit price for that period.

- [`tiers`](https://docs.stripe.com/api/v2/rate-cards/rate-card-rates/object.md?query=tiers) (array of objects)
  Each element represents a pricing tier. Cannot be set if `unit_amount` is provided.

- [`transform_quantity`](https://docs.stripe.com/api/v2/rate-cards/rate-card-rates/object.md?query=transform_quantity) (object, nullable)
  Apply a transformation to the reported usage or set quantity before computing the amount billed.

- `unit_amount` (string, nullable)
  The per-unit amount to be charged, represented as a decimal string in minor currency units with at most 12 decimal places. Cannot be set if `tiers` is provided.