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

# List file emissions

`GET /files/emissions`

Returns the banking files submitted to banks (e.g. payment order files) across every company accessible to the authenticated user. Results are paginated: use `limit` to control page size and pass the returned `nextPageToken` to fetch the next page. 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 emissions 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

- ListFilesEmissionsResponseSchema
  - `data` GetFilesEmissionResponseSchema[], required — File emissions matching the query.
    - `id` string, required — Embat ID of the file emission.
    - `groupId` string, required — Embat group ID the file belongs to.
    - `companyId` string, nullable — Embat company ID the file was submitted for, if identified.
    - `fileName` string, required — Name of the emitted file.
    - `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.
    - `user` UserFileSchema
      - `id` string, required — Embat ID of the user who requested the file emission.
      - `name` string, required — First name of the user.
      - `surname` string, nullable — Last name of the user.
    - `provider` string, required — Channel or provider through which the file was submitted.
    - `format` string, nullable — Format of the emitted file.
    - `emissionDate` string, date-time, required — Date the file was submitted to 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/versions/36ca48bf4489/schema)