---
title: "Get a lease by Id"
method: GET
path: "/leases/{id}"
---

# Get a lease by Id

`GET /leases/{id}`

## Path parameters

- `id` string, required

## Response `200`

OK

- Lease — Lease Details
  - `id` string — Lease ID
  - `principalId` string — principalId of the lease to get
  - `accountId` string — accountId of the AWS account
  - `leaseStatus` 'Active' | 'Inactive' — Status of the Lease. "Active": The principal is leased and has access to the account "Inactive": The lease has become inactive, either through expiring, exceeding budget, or by request.
  - `leaseStatusReason` 'LeaseExpired' | 'LeaseOverBudget' | 'LeaseDestroyed' | 'LeaseActive' | 'LeaseRolledBack' — A reason behind the lease status. "LeaseExpired": The lease exceeded its expiration time ("expiresOn") and the associated account was reset and returned to the account pool. "LeaseOverBudget": The lease exceeded its budgeted amount and the associated account was reset and returned to the account pool. "LeaseDestroyed": The lease was adminstratively ended, which can be done via the leases API. "LeaseActive": The lease is active. "LeaseRolledBack": A system error occurred while provisioning the lease. and it was rolled back.
  - `createdOn` number — creation date in epoch seconds
  - `lastModifiedOn` number — date last modified in epoch seconds
  - `budgetAmount` number — budget amount
  - `budgetCurrency` string — budget currency
  - `budgetNotificationEmails` string[] — budget notification emails
  - `leaseStatusModifiedOn` number — date lease status was last modified in epoch seconds
  - `expiresOn` number — date lease should expire in epoch seconds

## Other responses

- `403` — Failed to retrieve lease

## Changes

> 12 revisions in range; 7 could not be searched.

- **2019-10-21** `eed5055f8eb6` — 3 warning
  - the optional response header `Access-Control-Allow-Headers` removed for the status `200`
  - the optional response header `Access-Control-Allow-Methods` removed for the status `200`
  - the optional response header `Access-Control-Allow-Origin` removed for the status `200`

[Change history](https://skmtc.dev/optum/apis/namespace/changes/leases/:id/get.md)

---

[API](https://skmtc.dev/optum/apis/namespace.md) · [All operations](https://skmtc.dev/optum/apis/namespace/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optum/namespace/revisions/11d73002ea62/schema)