firestore.projects.databases.documents.list

GET {{baseUrl}}/v1/:parent/:collectionId?mask.fieldPaths=<string>&mask.fieldPaths=<string>&orderBy=<string>&pageSize=<integer>&pageToken=<string>&readTime=<string>&showMissing=<boolean>&transaction=<string>&$.xgafv=<string>&access_token=<string>&alt=<string>&callback=<string>&fields=<string>&key=<string>&oauth_token=<string>&prettyPrint=<boolean>&quotaUser=<string>&upload_protocol=<string>&uploadType=<string>

Lists documents.

Request Params

KeyDatatypeRequiredDescription
mask.fieldPathsstringThe list of field paths in the mask. See Document.fields for a field path syntax reference.
mask.fieldPathsstringThe list of field paths in the mask. See Document.fields for a field path syntax reference.
orderBystringThe order to sort results by. For example: priority desc, name.
pageSizestringThe maximum number of documents to return.
pageTokenstringThe next_page_token value returned from a previous List request, if any.
readTimestringReads documents as they were at the given time. This may not be older than 270 seconds.
showMissingstringIf the list should show missing documents. A missing document is a document that does not exist but has sub-documents. These documents will be returned with a key but will not have fields, Document.create_time, or Document.update_time set. Requests with show_missing may not specify where or order_by.
transactionstringReads documents in a transaction.
$.xgafvstringV1 error format.
access_tokenstringOAuth access token.
altstringData format for response.
callbackstringJSONP
fieldsstringSelector specifying which fields to include in a partial response.
keystringAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
oauth_tokenstringOAuth 2.0 token for the current user.
prettyPrintstringReturns response with indentations and line breaks.
quotaUserstringAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
upload_protocolstringUpload protocol for media (e.g. "raw", "multipart").
uploadTypestringLegacy upload protocol for media (e.g. "media", "multipart").

RESPONSES

status: OK

{&quot;documents&quot;:[{&quot;createTime&quot;:&quot;\u003cstring\u003e&quot;,&quot;fields&quot;:&quot;\u003cobject\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;updateTime&quot;:&quot;\u003cstring\u003e&quot;},{&quot;createTime&quot;:&quot;\u003cstring\u003e&quot;,&quot;fields&quot;:&quot;\u003cobject\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;updateTime&quot;:&quot;\u003cstring\u003e&quot;}],&quot;nextPageToken&quot;:&quot;pariatur do culpa reprehenderit&quot;}