---
title: "GET /usage-based-items/{usage_based_item_id}/tiers"
method: GET
path: "/usage-based-items/{usage_based_item_id}/tiers"
tags: ["usageBasedItemTiers"]
---

# GET /usage-based-items/{usage_based_item_id}/tiers

`GET /usage-based-items/{usage_based_item_id}/tiers`

## Request

- Base URL: `https://api.outdoorsy.com/v0`
- URL: `https://api.outdoorsy.com/v0/usage-based-items/{usage_based_item_id}/tiers`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `API-Key`
- TypeScript: <https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation/docs/usage-based-items/:usage_based_item_id/tiers/get.ts> (a function with typed inputs; its response is checked against the schema)

Return array of tiers for the specified usage based item

## Response `200`

- UsageBasedItemTier[]
  - `created` string
  - `id` integer
  - `maximum` number, double
  - `minimum_fee` integer
  - `owner_id` integer
  - `price` number, double
  - `tax_amount` integer
  - `total` integer
  - `updated` string
  - `usage_based_item_id` integer

## Other responses

- `400`: Invalid input or state means you're bad
- `401`: Unauthorized error
- `default`: An unknown, unexpected error.

---

[API](https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation.md) - [All operations](https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation/revisions/f0cf8f605ea0?raw)
