list

GET

lookup all documents across all resources which are currently on GroundX

Query parameters

nintegerOptional

The maximum number of returned documents. Accepts 1-100 with a default of 20.

filterstringOptional

Only documents with names that contain the filter string will be returned in the results.

sort"name" or "created"Optional

The document attribute that will be used to sort the results.

Allowed values: namecreated

sortOrder"asc" or "desc"Optional

The order in which to sort the results. A value for sort must also be set.

Allowed values: ascdesc

statusenumOptional

A status filter on the get documents query. If this value is set, then only documents with this status will be returned in the results.

Allowed values: queuedprocessingerrorcompletecancelled

nextTokenstringOptional

A token for pagination. If the number of documents for a given query is larger than n, the response will include a “nextToken” value. That token can be included in this field to retrieve the next batch of n documents.

Response

Look up success

documentslist of objectsOptional

nextTokenstringOptional

get

Up Next

Built with

1	from groundx import GroundX
2
3	client = GroundX(
4	api_key="YOUR_API_KEY",
5	)
6	client.documents.list()

1	{
2	"documents": [
3	{
4	"documentId": "documentId",
5	"bucketId": 1,
6	"fileName": "fileName",
7	"fileSize": "1.4MB",
8	"fileType": "txt",
9	"processId": "processId",
10	"searchData": {
11	"key": "value"
12	},
13	"sourceUrl": "sourceUrl",
14	"status": "queued",
15	"statusMessage": "statusMessage",
16	"xrayUrl": "xrayUrl"
17	}
18	],
19	"nextToken": "nextToken"
20	}