---
title: "Retrieve a commitment"
method: GET
path: "/analytics/v1/commitment-manager/{id}"
tags: ["Commitment Manager"]
---

# Retrieve a commitment

`GET /analytics/v1/commitment-manager/{id}`

Returns a commitment by the specified Id.

## Path parameters

- `id` string, required

## Response `200`

OK - Commitment returned.

- CommitmentExternal — A commitment contract.
  - `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 (e.g., USD).
  - `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.
- `404` — Not Found - The requested resource does not exist.

---

[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)