---
title: "Get Files"
method: GET
path: "/v2/issuers/{organizationId}/files/metadata"
tags: ["Files"]
---

# Get Files

`GET /v2/issuers/{organizationId}/files/metadata`

## Request

- Base URL: `https://rewards-api.getkard.com`
- URL: `https://rewards-api.getkard.com/v2/issuers/{organizationId}/files/metadata`
- Auth: HTTP bearer

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.
<b>Required scopes:</b> `files.read`

## Path parameters

- `organizationId` string, required: Your issuer organization ID, provided by Kard

## Query parameters

- `filter[dateFrom]` string
- `filter[dateTo]` string
- `filter[fileType]` 'earnedRewardApprovedDailyReconciliationFile' | 'earnedRewardSettledDailyReconciliationFile' | 'payoutReconciliationFile' | 'monthlyReconciliationFile' | 'cardlinkedReconciliationFile': Type of an issuer file. `payoutReconciliationFile` is the payout (monthly) reconciliation file; `monthlyReconciliationFile` is its deprecated alias, accepted in `filter[fileType]` and echoed back in `type` when used, to be removed in a later version. `cardlinkedReconciliationFile` is the daily card-linked reconciliation file (`cardlinked-reconciliation-YYMMDD.json`).
- `page[size]` integer
- `page[after]` string
- `page[before]` string
- `sort` 'sentDate' | '-sentDate'

## Response `200`

Response with status 200

- FilesGetFilesMetadataResponse
  - `data` FilesFileMetadataWithURL[], required: List of file metadata objects with their pre-signed URLs.
    - `type` 'earnedRewardApprovedDailyReconciliationFile' | 'earnedRewardSettledDailyReconciliationFile' | 'payoutReconciliationFile' | 'monthlyReconciliationFile' | 'cardlinkedReconciliationFile', required: Type of an issuer file. `payoutReconciliationFile` is the payout (monthly) reconciliation file; `monthlyReconciliationFile` is its deprecated alias, accepted in `filter[fileType]` and echoed back in `type` when used, to be removed in a later version. `cardlinkedReconciliationFile` is the daily card-linked reconciliation file (`cardlinked-reconciliation-YYMMDD.json`).
    - `attributes` FilesFileMetadataAttribute, required
      - `fileName` string, required: The name of the file. Under `filter[fileType]=payoutReconciliationFile` it is the file name with extension and no path. Under `monthlyReconciliationFile`, the daily file types or no filter it is the full storage key, kept until the deprecated name is removed.
      - `sentAt` string, required: ISO 8601 timestamp (ISO8601) when the file was originally sent/created.
      - `lastModified` string, required: ISO 8601 timestamp (ISO8601) when the file was last modified.
      - `downloadUrl` string, required: Temporary URL that provides direct access to download the file for 30 minutes.
      - `periodStart` string: Start of the reporting period, inclusive (RFC 3339, UTC). Present only when a period was informed at upload.
      - `periodEnd` string: End of the reporting period, inclusive (RFC 3339, UTC). Present only when a period was informed at upload.
    - `id` string, required: The File ID in Kard’s system
  - `links` CommonsLinks, required: Related links to the API call
    - `self` string, required
    - `prev` string
    - `next` string
  - `meta` FilesPaginationMeta, required
    - `pageSize` integer, required: Number of items per page.
    - `hasNextPage` boolean, required: Indicates if there are more pages available after the current one.

## Other responses

- `400`: Error response with status 400
- `401`: Error response with status 401
- `403`: Error response with status 403
- `429`: The issuer's traffic grew faster than its allowed rate, or the endpoint's own limit was reached. If the response includes a `Retry-After` header, wait that many seconds before retrying. See [Rate Limits](/2024-10-01/api/integration-guides/rate-limits).
- `500`: Error response with status 500

## Changes

- **2026-10-29** `bd47764afa21`: 1 warning, 1 info
  - added the new `cardlinkedReconciliationFile` enum value to the `data/items/type` response property for the response status `200`
  - added the new enum value `cardlinkedReconciliationFile` to the `query` request parameter `filter[fileType]`
- **2026-10-22** `4e87fc8b018b`: 1 warning, 2 info
  - added the new `payoutReconciliationFile` enum value to the `data/items/type` response property for the response status `200`
  - added the new enum value `payoutReconciliationFile` to the `query` request parameter `filter[fileType]`
  - added the non-success response with the status `429`
- **2026-10-19** `a664c5d23771`: 2 info
  - added the optional property `data/items/attributes/periodEnd` to the response with the `200` status
  - added the optional property `data/items/attributes/periodStart` to the response with the `200` status

[Operation history](https://skmtc.dev/getkard/apis/getkard-2/changes/v2/issuers/:organizationId/files/metadata/get.md)

---

[API](https://skmtc.dev/getkard/apis/getkard-2.md) - [All operations](https://skmtc.dev/getkard/apis/getkard-2/llms.txt) - [OpenAPI document](https://skmtc.dev/getkard/apis/getkard-2/revisions/bd47764afa21?raw)