Skip to content
Last updated
GET/v1/pricing-tiers/{tier_id}

Get a specific pricing tier by ID.

Returns pricing tier details including name, description, discount percentage, and active status.

tier_id string required

The unique identifier of the pricing tier to retrieve.

Returns

Returns a pricing tier object if found. Returns a 404 error if the tier doesn't exist.

cURL
curl https://api.aitronos.com/v1/pricing-tiers/tier_enterprise \
  -H "X-API-Key: $FREDDY_API_KEY"

Response

{
  "id": "tier_enterprise",
  "name": "Enterprise",
  "description": "Enterprise pricing tier with volume discounts",
  "discount_percentage": 15.0,
  "is_active": true
}

Error Responses

404 Not Found

{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Pricing tier 'tier_custom' not found",
    "system_message": "Pricing tier 'tier_custom' not found",
    "type": "client_error",
    "status": 404,
    "details": {
      "tier_id": "tier_custom"
    },
    "trace_id": "req_abc123xyz",
    "timestamp": "2025-12-22T15:30:00Z"
  }
}