Find items by document

Returns the ids of the items linked to a document whose contents are identical to the file you provide, limited to the items your service account can access. Matching is by file contents, not file name.

Send the file as multipart/form-data in the file field. The file is hashed (SHA-256) as it uploads and is not stored. The response includes that hash as file_hash. To fetch further pages without uploading the file again, call this endpoint with the file_hash query parameter and no request body. Send either file or file_hash, not both.

Results are ordered by item id and paged with an opaque cursor. Pass the next_cursor from one response as cursor on the next call until it is absent. If no accessible item is linked to the document, item_ids is an empty array.

Files up to 512 MB are accepted, and large uploads have up to 5 minutes to complete. Requests may be rate limited. When the limit is exceeded the API returns 429 with a Retry-After header giving the seconds to wait.

Requires an access token with the items:read scope.