Get File Metadata

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

dateFromstringOptional

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

dateTostringOptional

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

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).

sort[sent_at]enumOptional

Direction for sorting by sent date. Defaults to “DESC”.

Allowed values:
fileTypeenumOptional

The document file type.

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