Skip to navigation

/files/download/request-meta

Returns authenticated requests you can send to download files straight from the third-party provider, one per File. Use this when you need many files at once. Pass up to 100 file IDs in the ids parameter, or page through the full list. Each entry gives you the url, method and headers to use, and the content goes from the provider to you without passing through Merge. For how this works, see our direct file download help center article.

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.

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 export format help center article.

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 nullOptional
previousstring or nullOptional
resultslist of objectsOptional

Field support by integration

See all supported fields

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