Activities3

Agent Schedules6

Agents11

Alerts7

Annotation Queues10

Annotations2

API keys6

Audio3

Audit Logs1

Budgets6

Chat1

Chunking1

Completions1

Datasets11

Deployments2

Documentation1

Embeddings1

Evals9

Feedback4

File Systems10

Files6

Finder2

Guardrail Rules6

Human Review Sets5

Identities5

Images3

Knowledge Bases23

Logs10

Management keys6

MCP Gateway13

Memory Stores15

Model Catalog3

Model Sharing1

Models17

Moderations1

Notifiers5

Policies5

Projects5

Prompts7

Reporting1

Rerank1

Responses2

Router1

Routing Rules6

Skills5

Smart Routers5

Tools7

Traces9

Webhooks8

Workspace Security8

Workspace Settings2

Workspaces3

Identities

Retrieve an identity

Retrieves detailed information about a specific identity using their identity ID or external ID from your system.

get/v2/identities/{id}

Path parameters

idstring required

Identity ID to retrieve.

Query parameters

include_metricsboolean

Include aggregate usage metrics on the returned identity.

include_budgetboolean

When true, embed the identity-scoped budget (config and limits only, no live usage) on the returned record.

Response

Changes

Changed in 8 of the 257 revisions of this API.36

Aug 28, 20269642bb8e4f831See the full diff
- ●
  removed the optional property identity/allOf[Identity]/budget/allOf[Budget]/scope/allOf[BudgetScope]/factory from the response with the 200 status
  response-optional-property-removed
This revision also has 39 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 27, 2026a38e9ab597711See the full diff
- ○
  added the optional property identity/allOf[Identity]/budget/allOf[Budget]/scope/allOf[BudgetScope]/factory to the response with the 200 status
  response-optional-property-added
This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 17, 20262f27caf6888c1See the full diff
- ○
  added the optional property identity/allOf[Identity]/budget/allOf[Budget]/alerts to the response with the 200 status
  response-optional-property-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 16, 2026bee257c5b2481See the full diff
- ●
  removed the optional property identity/allOf[Identity]/budget/allOf[Budget]/alerts from the response with the 200 status
  response-optional-property-removed
This revision also has 49 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 16, 2026801f61a5a0561See the full diff
- ○
  added the optional property identity/allOf[Identity]/budget/allOf[Budget]/alerts to the response with the 200 status
  response-optional-property-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 16, 202642d5d20625271See the full diff
- ●
  removed the optional property identity/allOf[Identity]/budget/allOf[Budget]/alerts from the response with the 200 status
  response-optional-property-removed
This revision also has 49 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 10, 2026d418091db1631See the full diff
- ○
  added the optional property identity/allOf[Identity]/budget/allOf[Budget]/alerts to the response with the 200 status
  response-optional-property-added
Jun 30, 2026877151607ea92See the full diff
- ○
  added the new optional query request parameter include_budget
  new-optional-request-parameter
- ○
  added the optional property identity/allOf[Identity]/budget to the response with the 200 status
  response-optional-property-added

Of the 257 revisions, 71 have no diff computed.

Full history