---
title: "List commitments"
method: GET
path: "/analytics/v1/commitment-manager"
tags: ["Commitment Manager"]
---

# List commitments

`GET /analytics/v1/commitment-manager`

Returns a list of commitments for the customer.
Commitments are listed in reverse chronological order by default.

## Query parameters

- `sortBy` 'name' | 'startDate' | 'endDate' | 'provider' | 'createTime' | 'updateTime'
- `sortOrder` 'asc' | 'desc'
- `maxResults` string
- `pageToken` string
- `filter` string

## Response `200`

OK - The request succeeded.

- CommitmentExternalList — List of commitments.
  - `pageToken` string — Page token. It is used to request a specific page of the list results.
  - `rowCount` integer — The number of returned records.
  - `commitments` CommitmentExternalListItem[] — Array of commitments.
    - `id` string — The unique identifier of the commitment.
    - `name` string — The name of the commitment.
    - `startDate` string, date-time — The start date of the commitment.
    - `endDate` string, date-time — The end date of the commitment.
    - `currency` string — The currency of the commitment.
    - `cloudProvider` 'google-cloud' | 'amazon-web-services' | 'microsoft-azure' — The cloud provider associated with the commitment.
    - `totalCommitmentValue` number, double — The total value of the commitment across all periods.
    - `totalCurrentAttainment` number, double — The total current spend attainment across all periods.
    - `totalMarketplaceSpend` number, double — The total marketplace spend across all periods.
    - `totalForecastValue` number, double — The total projected spend at the end of the commitment, summed across all periods. 0 when insufficient history is available to compute a forecast.
    - `periods` CommitmentPeriod[] — The list of commitment periods.
      - `startDate` string, date-time — The start date of the period.
      - `endDate` string, date-time — The end date of the period.
      - `commitmentValue` number, double — The commitment value for this period.
      - `marketplaceLimitPercentage` number, double — The marketplace limit as a percentage (0-100).
      - `marketplaceSpend` number, double — The marketplace spend within this period.
      - `marketplaceLimitAmount` number, double — The marketplace limit in absolute currency for this period, derived as commitmentValue * marketplaceLimitPercentage / 100.
      - `forecastValue` number, double — The projected spend at the end of this period, based on a linear regression over the period's total spend series. 0 when insufficient history is available to compute a forecast.
    - `createTime` integer — The creation time in milliseconds since epoch.
    - `updateTime` integer — The last update time in milliseconds since epoch.

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.
- `500` — Internal Server Error - Something went wrong with the DoiT API server.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)