---
title: "Get files"
method: GET
path: "/files"
tags: ["Files"]
---

# Get files

`GET /files`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/files`
- Auth: HTTP bearer

The `/files` endpoint provides access to an entity's files hosted on Monite's servers. This includes both files uploaded by the entity and files that were automatically created by Monite (such as PDF versions of invoices).

`GET /files` requires at least one query parameter, either `id__in` or `file_type`. You can use this operation to:

 * Bulk fetch multiple files by IDs.
 * Get all files with the given purpose (for example, invoice attachments).

If no files matching the query parameters were found, the response contains an empty `data` array.

Both partner tokens and entity user tokens can be used for authentication.

## Query parameters

- `id__in` string, uuid
- `file_type` 'ocr_results' | 'ocr_files' | 'payables' | 'receivables' | 'delivery_notes' | 'receipts' | 'userpics' | 'entity_logo' | 'companies_logo' | 'zip' | 'identity_documents' | 'additional_identity_documents' | 'receivable_signatures' | 'einvoices_xml' | 'attachments'

## Headers

- `x-monite-version` string, required

## Response `200`

Successful Response

- FilesResponse
  - `data` FileResponse[], required
    - `id` string, uuid, required: A unique ID assigned to this file.
    - `created_at` string, date-time, required: Date and time when this file was uploaded to or created in Monite. Timestamps follow the ISO 8601 format.
    - `updated_at` string, date-time, required: Date and time when this file was last updated in Monite. Timestamps follow the ISO 8601 format.
    - `file_type` string, required: Possible values: * `additional_identity_documents` and `identity_documents` - [entity verification documents](https://docs.monite.com/payments/onboarding/via-api/documents) uploaded for payments onboarding. * `attachments` - supplementary attachments for accounts receivable invoices, quotes, and credit notes. * `delivery_notes` - auto-generated PDF versions of delivery notes. * `einvoices_xml` - e-invoice XML generated when sending e-invoices. * `payables` - payables (bills) received via email or uploaded via API. * `receivable_signatures` - images of customer signatures provided during quote acceptance. * `receivables` - auto-generated PDF versions of invoices, quotes, and credit notes. * `zip` - data export archives created by `POST /data_exports`.
    - `md5` string, required: The MD5 hash of the file.
    - `mimetype` string, required: The file's media type, for example, `application/pdf` or `image/png`.
    - `name` string, required: The original file name (if available).
    - `region` string, required: Geographical region of the data center where the file is stored.
    - `s3_bucket` string, required: Unused.
    - `s3_file_path` string, required: Unused.
    - `size` integer, required: The file size in bytes.
    - `url` string, required: The URL to download the file.

## Other responses

- `401`: The `Authorization` header is missing or contains an invalid or expired access token. See [Authentication](https://docs.monite.com/api/concepts/authentication) to learn how to authenticate API calls.
- `422`: Validation Error
- `429`: API rate limit has been exceeded. Check the response headers for the rate limit information.

---

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