Go to console

Method: projects.databases.documents.get

Gets a single document.

HTTP request

GET https://firestore.googleapis.com/v1beta1/{name=projects/*/databases/*/documents/*/**}

The URL uses gRPC Transcoding syntax.

Path parameters



The resource name of the Document to get. In the format: projects/{project_id}/databases/{database_id}/documents/{document_path}.

Query parameters



The fields to return. If not set, returns all fields.

If the document has a field that is not present in this mask, that field will not be returned in the response.

Union parameter consistency_selector. The consistency mode for this transaction. If not set, defaults to strong consistency. consistency_selector can be only one of the following:

string (bytes format)

Reads the document in a transaction.

A base64-encoded string.


string (Timestamp format)

Reads the version of the document at the given time. This may not be older than 60 seconds.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Document.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.