API ReferenceFiles

Get Files

Retrieves metadata for files associated with a specific issuer/organization. This endpoint supports pagination and sorting options to efficiently navigate through potentially large sets of file metadata. Required scopes: files.read

Path parameters

organizationIdstringRequired
Your issuer organization ID, provided by Kard

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

filter[dateFrom]stringOptional

Start date for filtering files (format ISO8601). If not provided, defaults to current date minus 1 month.

filter[dateTo]stringOptional

End date for filtering files (format ISO8601). If not provided, defaults to current date.

filter[fileType]enumOptional
The document file type.
Allowed values:
page[size]integerOptional
Number of items per page. Defaults to 10 if not specified and maximum value allowed 100 items per page.
page[after]stringOptional

Cursor for forward pagination (next page).

page[before]stringOptional

Cursor for backward pagination (previous page).

sortenumOptional

If provided, response will be sorted by the specified fields. Defaults to descending sentDate, equivalent to “-sentDate”

Allowed values:

Response

This endpoint returns an object.
datalist of objects

List of file metadata objects with their pre-signed URLs.

metaobject
Metadata about the pagination status.

Errors