For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
Resources
Log inGet a demo
Get startedAPI referenceImplementation
Get startedAPI referenceImplementation
    • Overview
    • File Picker
          • The File object
          • GET/files
          • POST/files
          • GET/files/{id}
          • GET/files/{id}/download
          • GET/files/{id}/download/request-meta
          • GET/files/download/request-meta
          • GET/files/meta/post
UnifiedAgent HandlerGateway
UnifiedAgent HandlerGateway
Resources
Log inGet a demo
Common ModelsFiles

/files/download/request-meta

GET
/filestorage/v1/files/download/request-meta
GET
/api/filestorage/v1/files/download/request-meta
$curl -G https://api.merge.dev/api/filestorage/v1/files/download/request-meta \
>     -H "X-Account-Token: X-Account-Token" \
>     -H "Authorization: Bearer <token>" \
>     -d cursor=cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw
200Retrieved
1{
2  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
3  "previous": "cj1sZXdwd2VycWVtY29zZnNkc2NzUWxNMEUxTXk0ME16UXpNallsTWtJ",
4  "results": [
5    {
6      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
7      "url": "https://www.googleapis.com/drive/v3/files/234?alt=media",
8      "method": "GET",
9      "headers": {
10        "Authorization": "Bearer 1234"
11      }
12    }
13  ]
14}

Returns metadata to construct authenticated file download requests, allowing you to download files directly from the third-party.

Field support by integration

See all supported fields

Use the /linked-accounts endpoint to pull platform support information

Was this page helpful?
Previous

/files/{id}/download/request-meta

Next

/files/meta/post

Built with

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Headers

X-Account-TokenstringRequired
Token identifying the end user.

Query parameters

created_afterstringOptional
If provided, will only return objects created after this datetime.
created_beforestringOptional
If provided, will only return objects created before this datetime.
cursorstringOptional
The pagination cursor value.
idslist of stringsOptional

If provided, will only return objects with the given IDs. Comma-separated list of strings.

include_deleted_databooleanOptional
Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/).
mime_typesstringOptional
A comma-separated list of preferred MIME types in order of priority. If supported by the third-party provider, the file(s) will be returned in the first supported MIME type from the list. The default MIME type is PDF. To see supported MIME types by file type, refer to our <a href='https://help.merge.dev/en/articles/8615316-file-export-and-download-specification' target='_blank'>export format help center article</a>.
modified_afterstringOptional
If provided, will only return objects modified after this datetime.
modified_beforestringOptional
If provided, will only return objects modified before this datetime.
order_byenumOptional

Overrides the default ordering for this endpoint. Possible values include: created_at, -created_at, modified_at, -modified_at.

Allowed values:
page_sizeintegerOptional
Number of results to return per page. The maximum limit is 100.

Response

nextstring or null
previousstring or null
resultslist of objects

Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.

A comma-separated list of preferred MIME types in order of priority. If supported by the third-party provider, the file(s) will be returned in the first supported MIME type from the list. The default MIME type is PDF. To see supported MIME types by file type, refer to our export format help center article.