---
title: "List file receptions"
method: GET
path: "/files/receptions"
tags: ["Files"]
---

# List file receptions

`GET /files/receptions`

Returns the banking files received across every company accessible to the authenticated user (e.g. account statements or confirmation files sent by a bank). Results are paginated: use `limit` to control page size and pass the returned `nextPageToken` to fetch the next page. Download the content of a specific file with `GET /files/receptions/{fileId}`. Errors from the file service are reported with their original status code and message, so responses may include statuses other than the ones listed here.

## Query parameters

- `limit` integer — Maximum number of file receptions to return. Defaults to 500, up to 2000.
- `nextPageToken` string — Token to fetch the next page of results, returned by a previous call to this endpoint.

## Response `200`

Successful Response

- ListFilesReceptionsResponseSchema
  - `data` GetFilesReceptionResponseSchema[], required — File receptions matching the query.
    - `id` string, required — Embat ID of the file reception.
    - `groupId` string, required — Embat group ID the file belongs to.
    - `companyId` string, nullable — Embat company ID the file was matched to, if identified.
    - `fileName` string, required — Name of the file as received from the bank.
    - `bank` BankFileSchema
      - `id` string, nullable — Identifier of the bank associated with the file.
      - `fullName` string, nullable — Full name of the bank.
      - `service` string, nullable — Banking service or channel used to exchange the file with the bank.
      - `countryCode` string, nullable — ISO country code of the bank.
    - `downloaded` boolean, required — Whether the file has already been downloaded.
    - `provider` string, required — Channel or provider through which the file was received.
    - `receptionDate` string, date-time, required — Date the file was received from the bank.
    - `createdAt` string, date-time, required — Created date of the entity in the database
    - `updatedAt` string, date-time, required — Last updated date of the entity in the database
  - `nextPageToken` string, nullable — Token to fetch the next page of results. `null` when there are no more pages.

## Other responses

- `401` — Unauthorized. The bearer token is missing, invalid or expired.
- `422` — Validation Error

---

[API](https://skmtc.net/embat/apis/embat-api.md) · [All operations](https://skmtc.net/embat/apis/embat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/embat/embat-api/revisions/36ca48bf4489/schema)