---
title: "Search Account Documents"
method: POST
path: "/v1/accounts/me/documents/search"
tags: ["Document Access"]
---

# Search Account Documents

`POST /v1/accounts/me/documents/search`

Returns a list of all documents belonging to the requesting user's account, sorted by created date. This API is exclusive to Enterprise Shield accounts. The endpoint supports pagination and has a per-account rate limit of 300 requests per 5 seconds.

## Headers

- `Lucid-Request-As` string, required

## Request body

- object
  - `userIds` number[] — When provided, limit the search to documents that at least one specified user can access. If no list is provided, search across the entire account.
  - `ownedByUsers` boolean — When true, search results will only include documents owned by users specified by userIds. Ignored if no userIds are provided.
  - `documentIds` string[] — List of documentIds to filter by.
  - `classificationIds` string[] — List of classificationIds to filter by.
  - `statusIds` number[] — List of statusIds to filter by.
  - `createdStartTime` string, date-time — Start of range to filter documents by created time.
  - `createdEndTime` string, date-time — End of range to filter documents by created time.
  - `lastModifiedStartTime` string, date-time — Start of range to filter documents by last modified time.
  - `lastModifiedEndTime` string, date-time — End of range to filter documents by last modified time.
  - `product` Product[] — Array of Lucid Suite products to filter by. Default value assumes all valid products for the given scopes.
  - `keywords` string — Keyword(s) to search against document content and titles. When provided, results will be sorted by relevance to keyword search. Use quotes to search for exact phrases (e.g. "Project X")
  - `documentLocation` 'team folders' | 'users' | 'deleted' | 'repositories' — Specify to search for documents in team folders, owned by users, deleted, or contained within repositories
  - `externalAccess` 'any' | 'external-collaborators' | 'external-links' — Specify to search for documents with either “any” type of external access, “external-collaborators”, or "external-links"

## Response `200`

With paginated list of Account Documents

- AccountDocument[]
  - `documentId` string, uuid, required — Unique ID of the document
  - `title` string, required — Title of the document
  - `adminViewUrl` string, uri, required — Link to view the document
  - `created` string, date-time, required — Date and time of when the document was created
  - `owner` object, required
    - `ownerType` string — user or account
    - `id` number — userId or accountId
  - `lastModified` string, date-time, required — Date and time of when the document was last modified
  - `trashed` string, date-time, nullable — If defined, the timestamp when the document was moved to the trash
  - `customTags` string[], required — List of any custom tags assigned to the document
  - `product` 'lucidchart' | 'lucidscale' | 'lucidspark', required — The Lucid Suite product that a document was created in.
  - `status` string, nullable — Current assigned status of the document
  - `classification` string, nullable — Current assigned classification of the document
  - `parent` integer, nullable — ID of the parent folder
  - `userCollaboratorIds` integer[], required — List of IDs of users that are collaborators on the document
  - `teamCollaboratorIds` integer[], required — List of IDs of teams that are collaborators on the document

## Other responses

- `400` — Bad Request if incorrect format
- `403` — Forbidden if "product" query parameter is used and the token’s scopes do not contain the matching readonly scope for each product, or account does not have access to the API
- `429` — Too Many Requests if account makes more than 300 requests in 5 seconds

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/revisions/6a32cb9e1aa7/schema)