---
title: "/commitments"
method: GET
path: "/v1/org/{org_id}/commitments"
tags: ["Commitments"]
---

# /commitments

`GET /v1/org/{org_id}/commitments`

Retrieves a paginated list of commitments for the specified organization and time period. Returns detailed information about each commitment including utilization, savings, and status. Results can be filtered by provider, search term, and custom criteria, and sorted by various attributes.

## Query parameters

- `search` string
- `filter` object, nullable
- `desc` boolean
- `order_by` 'duration_seconds' | 'start_date' | 'end_date' | 'upfront_cost' | 'amortized_cost' | 'recurring_cost' | 'created_at' | 'updated_at' | 'is_leased' | 'account_id' | 'type' | 'status' | 'scope' | 'reservation_end' | 'utilization' | 'monthly_savings' | 'null', nullable
- `provider` 'aws' | 'azure' | 'gcp', required
- `start_date` string, date, required
- `end_date` string, date, required
- `page` integer
- `page_size` integer

## Response `200`

OK

- PublicCommitment[]
  - `id` string, uuid, required
  - `provider` 'aws' | 'azure' | 'gcp', required
  - `display_name` string, required
  - `leased_display_name` string, required
  - `provider_reservation_id` string, required
  - `account_id` string, nullable, required
  - `master_account_id` string, nullable, required
  - `billing_account_id` string, nullable, required
  - `type` string, required
  - `region` string, nullable, required
  - `duration_seconds` integer, nullable, required
  - `reservation_end` string, nullable, required
  - `reservation_start` string, nullable, required
  - `transfer_reservation_start` string, date-time, nullable, required
  - `transfer_reservation_end` string, date-time, nullable, required
  - `start_date` string, date-time, nullable, required
  - `end_date` string, date-time, nullable, required
  - `status` 'active' | 'locked' | 'new' | 'reselling' | 'unlocked' | 'unknown' | 'cancelled' | 'expired' | 'recently_expired' | 'resold' | 'removed', required
  - `is_leased` boolean, required
  - `is_active` boolean, required
  - `lease` LeaseMenuItem, required
    - `id` string, uuid
    - `fee_type` string, required
    - `fee_rate` number, required
    - `is_rebate` boolean, required
    - `lockin_months` integer, required
    - `term_months` integer, required
  - `lease_start` string, date-time, nullable, required
  - `lease_lockin_date` string, date-time, nullable, required
  - `upfront_cost` number, required
  - `recurring_cost` number, required
  - `is_flexible` boolean, nullable, required
  - `payment_option` unknown, required
  - `offering_class` unknown, required
  - `offering_id` string, nullable, required
  - `instance_count` integer, nullable, required
  - `effective_instance_count` integer, nullable, required
  - `product_description` string, nullable, required
  - `instance_family` string, nullable, required
  - `instance_type` string, nullable, required
  - `tenancy` string, nullable, required
  - `az` string, nullable, required
  - `is_multi_az` boolean, nullable, required
  - `plan_type` string, nullable, required
  - `scope` unknown, required
  - `name` string, nullable, required
  - `order_id` string, nullable, required
  - `resource_group` string, nullable, required
  - `instance_flexibility` boolean, nullable, required
  - `savings` number, nullable, required
  - `monthly_savings` number, nullable, required
  - `net_savings` number, nullable, required
  - `utilization` number, nullable, required
  - `potential_savings` number, nullable, required
  - `running_hours` number, nullable, required
  - `amortized_cost` number, nullable, required
  - `daily_utilizations` DailyUtilization[], required
    - `date` string, date, required
    - `reservation_utilization` number, required
    - `covered_cost` number, required
    - `cost` number, required
    - `potential_savings` number, nullable, required
    - `running_hours` number, nullable, required
    - `savings` number, required
    - `unutilized_commit` number, required
    - `gri_fees` number, required
    - `net_savings` number, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `405` — Method not allowed
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal server error
- `default` — Default error response

---

[API](https://skmtc.net/archera/apis/archera-ai-api.md) · [All operations](https://skmtc.net/archera/apis/archera-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archera/archera-ai-api/revisions/ed4f8fa35f31/schema)