Search Documents

Retrieves information about documents that the authenticated user has at least read only access to.

By default, documents are sorted by created date from oldest to newest. Providing the keywords parameter will cause the documents to be sorted by relevance instead.

📘

This endpoint is paginated. For more information, see Pagination .

📘

This endpoint has a per account rate limit of 300 requests per 5 seconds.


Valid Authentication Methods

API Key Grants:

  • DocumentReadonly

OAuth 2.0 User Token Scopes:

  • lucidchart.document.content:readonly
  • lucidscale.document.content:readonly
  • lucidspark.document.content:readonly

Body Params
product
array of objects
Defaults to lucidchart,lucidscale,lucidspark

Array of Lucid Suite products to filter by. Default value assumes all valid products for the given scopes.

product
Allowed:
date-time
Defaults to 0001-01-01T00:00:00Z

Date and time to filter documents that have been created after. Default value assumes the beginning of time.

date-time
Defaults to 9999-12-31T23:59:59Z

Date and time to filter documents that have been created before. Default value assumes the current instant of time.

date-time
Defaults to 0001-01-01T00:00:00Z

Date and time to filter documents that have been modified after. Default value assumes the beginning of time.

string

Keywords to search against document content and titles. This field is truncated to 400 characters. When provided, results will be sorted by relevance to keyword search.

boolean
Defaults to false

When set to true, excludes trashed/deleted documents from search results. When set to false or omitted, trashed documents are included in results with their trashedTimestamp populated.

string
enum

When provided, restricts search results to documents contained within repositories the authenticated user can access. Only the value "repositories" is supported on this endpoint.

Allowed:
Responses

400

Bad Request if the request does not contain a body.

403

Forbidden if the product query parameter is used and the token's scopes do not contain the matching readonly scope for each product.

429

Too Many Requests if the account makes more than 300 requests in 5 seconds.

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json