---
title: "Changes to READ: Retrieves a single document from the collection"
method: GET
path: "/{collection}/{identifier}"
---

# Changes to READ: Retrieves a single document from the collection

`GET /{collection}/{identifier}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 6 revisions.

- **2026-07-17** `5b0d424433e1` — 1 info
- **2021-01-07** `8252719e8e34` — 1 breaking, 11 info
- **2020-01-12** `4f4eedb269d0` — 3 info
- **2019-11-02** `6b2eb690f4ab` — 6 info
- **2019-10-09** `e3a793475629` — 8 breaking, 2 warning, 6 info

## Changes

- **2026-07-17** `5b0d424433e1` — 1 info
  - the endpoint scheme security `accessToken` was removed from the API
- **2021-01-07** `8252719e8e34` — 1 breaking, 11 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - the endpoint scheme security `accessToken` was added to the API
  - the endpoint scheme security `jwtoken` was added to the API
  - the endpoint scheme security `apiKeyAuth` was removed from the API
  - removed `#/components/schemas/DeviceStatus, #/components/schemas/Entry, #/components/schemas/Food, #/components/schemas/Profile, #/components/schemas/Settings, #/components/schemas/Treatment` from the response body `oneOf` list for the response status `200`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - added the media type `application/json` for the response with the status `404`
  - added the media type `application/json` for the response with the status `406`
  - added the media type `application/json` for the response with the status `410`
  - added the optional property `result` to the response with the `200` status
  - added the optional property `status` to the response with the `200` status
- **2020-01-12** `4f4eedb269d0` — 3 info
  - added the media type `application/xml` for the response with the status `200`
  - added the media type `text/csv` for the response with the status `200`
  - added the non-success response with the status `406`
- **2019-11-02** `6b2eb690f4ab` — 6 info
  - added the optional property `oneOf[#/components/schemas/DeviceStatus]/allOf[#/components/schemas/DocumentBase]/isReadOnly` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Entry]/allOf[#/components/schemas/DocumentBase]/isReadOnly` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Food]/allOf[#/components/schemas/DocumentBase]/isReadOnly` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Profile]/allOf[#/components/schemas/DocumentBase]/isReadOnly` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Settings]/allOf[#/components/schemas/DocumentBase]/isReadOnly` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/Treatment]/allOf[#/components/schemas/DocumentBase]/isReadOnly` to the response with the `200` status
- **2019-10-09** `e3a793475629` — 8 breaking, 2 warning, 6 info
  - added `#/components/schemas/DeviceStatus, #/components/schemas/Entry, #/components/schemas/Food, #/components/schemas/Profile, #/components/schemas/Settings, #/components/schemas/Treatment` to the response body `oneOf` list for the response status `200`
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `403`
  - removed the media type `application/json` for the response with the status `404`
  - removed the media type `application/json` for the response with the status `410`
  - removed the media type `application/xml` for the response with the status `200`
  - removed the media type `text/csv` for the response with the status `200`
  - removed the optional property `result` from the response with the `200` status
  - removed the optional property `status` from the response with the `200` status
  - the endpoint scheme security `apiKeyAuth` was added to the API
  - the endpoint scheme security `jwtoken` was removed from the API
  - added the new optional `header` request parameter `Date` to all path's operations
  - added the new optional `query` request parameter `now` to all path's operations
  - added the new optional `query` request parameter `token` to all path's operations
  - removed the non-success response with the status `406`

---

[Operation](https://skmtc.dev/nightscout/apis/nightscout-api/docs/:collection/:identifier/get.md) · [API](https://skmtc.dev/nightscout/apis/nightscout-api.md) · [Page](https://skmtc.dev/nightscout/apis/nightscout-api/changes/:collection/:identifier/get)