---
title: "Changes to GET /api/v1/{context_id}/principals"
method: GET
path: "/api/v1/{context_id}/principals"
---

# Changes to GET /api/v1/{context_id}/principals

`GET /api/v1/{context_id}/principals`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 1 of 5 revisions.

- **2026-08-24** `9f1598713067` — 1 breaking, 7 info

## Changes

- **2026-08-24** `9f1598713067` — 1 breaking, 7 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the new optional `query` request parameter `count`
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `limit`
  - added the non-success response with the status `400`
  - added the non-success response with the status `503`
  - added the required property `page` to the response with the `200` status
  - added the required property `principals` to the response with the `200` status

---

[Operation](https://skmtc.dev/surrealdb/apis/spectron/docs/api/v1/:context_id/principals/get.md) · [API](https://skmtc.dev/surrealdb/apis/spectron.md) · [Page](https://skmtc.dev/surrealdb/apis/spectron/changes/api/v1/:context_id/principals/get)