📆 Don't miss our Sanity Showcase virtual meetup on March 20th!

Doc

Get documents without caching limitations.

This endpoint cuts through any caching/indexing middleware that may involve delayed processing. It is designed for use cases where you want to be very sure to get the absolute latest possible version of a document as it is known to the backend. It can only fetch documents by id (i.e. no GROQ) and it is less scalable/performant than the other query-mechanisms, so should be used sparingly.

Get documents

GET /data/doc/:dataset/:documentIds

Path parameters

  • REQUIREDdatasetstring

    Indicates the target dataset for the query

  • REQUIREDdocumentIdsstring|strings

    A comma-separated list of document IDs. Do not include spaces. Example: documentID1,documentID2,documentID3

Query parameters

  • includeAllVersionsboolean

    Set to true to return all versions, including drafts and releases, matching the published document ID. Defaults to false.

Example

Request documents

Input

GET /data/doc/production/movie_01,movie_02,movie_03

Output

{
  "documents": [<array of documents with all attributes>]
}

Was this article helpful?