---
title: "Changes to Get agent by ID"
method: GET
path: "/agents/{agentId}"
---

# Changes to Get agent by ID

`GET /agents/{agentId}`

> Every recorded change to this operation, newest first.
> 116 revisions in range; 2 not diffed.

## Timeline

Changed in 9 of 116 revisions.

- **2026-10-28** `d996ddfb9d2b`: 3 info
- **2026-10-28** `5abf2bb56bcb`: 1 warning
- **2026-10-20** `761d1d030cb5`: 1 warning
- **2026-10-18** `add40cac0f84`: 1 warning
- **2026-10-18** `6d80d648535e`: 2 warning
- **2026-10-16** `2eefcc6aa9bc`: 1 warning
- **2026-10-14** `6875d86545f1`: 1 info
- **2026-10-02** `dfe5a02f2fee`: 6 breaking, 15 warning, 4 info
- **2026-05-28** `d0bce562bffd`: 1 info

## Changes

- **2026-10-28** `d996ddfb9d2b`: 3 info
  - added the optional property `details/permission` to the response with the `403` status
  - added the optional property `details/policyDenialReason` to the response with the `403` status
  - added the optional property `details/refusalReason` to the response with the `403` status
- **2026-10-28** `5abf2bb56bcb`: 1 warning
  - added the new `CORRIDOR_UNDER_MAINTENANCE` enum value to the `code` response property for the response status `403`
- **2026-10-20** `761d1d030cb5`: 1 warning
  - added the new `ISSUE_CARDS` enum value to the `policy/permissions/items/` response property for the response status `200`
- **2026-10-18** `add40cac0f84`: 1 warning
  - added the new `DESTINATION_NOT_ALLOWED` enum value to the `code` response property for the response status `403`
- **2026-10-18** `6d80d648535e`: 2 warning
  - added the new `MANAGE_CARDS` enum value to the `policy/permissions/items/` response property for the response status `200`
  - added the new `RECEIVE_FUNDS` enum value to the `policy/permissions/items/` response property for the response status `200`
- **2026-10-16** `2eefcc6aa9bc`: 1 warning
  - added the new `MANAGE_IDENTITY` enum value to the `policy/permissions/items/` response property for the response status `200`
- **2026-10-14** `6875d86545f1`: 1 info
  - added the non-success response with the status `403`
- **2026-10-02** `dfe5a02f2fee`: 6 breaking, 15 warning, 4 info
  - removed the required property `message` from the response with the `401` status
  - removed the required property `message` from the response with the `404` status
  - removed the required property `message` from the response with the `500` status
  - removed the required property `status` from the response with the `401` status
  - removed the required property `status` from the response with the `404` status
  - removed the required property `status` from the response with the `500` status
  - added the new `ACCOUNT_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `AUTH_METHOD_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `CUSTOMER_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `DOCUMENT_HOLDER_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `PAYMENT_DOCUMENT_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `PAYMENT_URL_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `PLATFORM_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `REQUEST_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `SESSION_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `STABLECOIN_EXTERNAL_ACCOUNT_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `STABLECOIN_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `STABLECOIN_OPERATION_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `STABLECOIN_PROVIDER_ACCOUNT_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - added the new `VERIFICATION_NOT_FOUND` enum value to the `code` response property for the response status `404`
  - removed the `CREATE_TRANSFERS` enum value from the `policy/permissions/items/` response property for the response status `200`
  - added the required property `reason` to the response with the `401` status
  - added the required property `reason` to the response with the `404` status
  - added the required property `reason` to the response with the `500` status
- **2026-05-28** `d0bce562bffd`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/lightsparkdev/apis/grid-api/docs/agents/:agentId/get.md) - [API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [Page](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/agents/:agentId/get)