Skip to main content
Solved

https://api.lucid.co/documents/search endpoint does not return all documents

  • May 25, 2026
  • 1 reply
  • 13 views

Forum|alt.badge.img

Hi,

 

I am using https://api.lucid.co/documents/search endpoint for search documents on our domain.

 

But when i try this endpoint, it only returns one record. In our domain we have 40 diagram that i found.

 

My curl is like that;

curl --location 'https://api.lucid.co/documents/search' \

--header 'Authorization: Bearer my-key \

--header 'Lucid-Api-Version: 1' \

--header 'Content-Type: application/json' \

--data '{

"product": [

"lucidchart"

]

}'

 

Only one document returns :(

 

What is the problem, is there a sign for seeing in filter in documents?

Best answer by Michael B

Hello,

 

A few thoughts come to mind that could be affected your expected results:

 

  1. Your request is filtered on the product `lucidchart`, so no `lucidspark` or `cloud accelerator` documents will be returned. If you remove the product array, documents of all types will be included.
    1. Note: If using OAuth2, the response will be automatically filtered by which scopes the calling token has authorized. To retrieve all document types, be sure to use all three scopes. API Keys support all three document types automatically.
  2. https://developer.lucid.co/reference/searchdocuments only returns documents the user has direct access to. Often, users who are document admins call this endpoint expecting to see all documents on the account. This endpoint does not support that.
    1. To be able to retrieve all documents on the account, it must have Enterprise Shield and then document admins can use the https://developer.lucid.co/reference/searchaccountdocuments endpoint

Let me know if neither of these contain the solution and we can investigate further.

Comments

Michael B
Forum|alt.badge.img+4
  • Lucid product team
  • Answer
  • May 26, 2026

Hello,

 

A few thoughts come to mind that could be affected your expected results:

 

  1. Your request is filtered on the product `lucidchart`, so no `lucidspark` or `cloud accelerator` documents will be returned. If you remove the product array, documents of all types will be included.
    1. Note: If using OAuth2, the response will be automatically filtered by which scopes the calling token has authorized. To retrieve all document types, be sure to use all three scopes. API Keys support all three document types automatically.
  2. https://developer.lucid.co/reference/searchdocuments only returns documents the user has direct access to. Often, users who are document admins call this endpoint expecting to see all documents on the account. This endpoint does not support that.
    1. To be able to retrieve all documents on the account, it must have Enterprise Shield and then document admins can use the https://developer.lucid.co/reference/searchaccountdocuments endpoint

Let me know if neither of these contain the solution and we can investigate further.