---
title: "Get a file by ID"
method: GET
path: "/files/{file_id}"
tags: ["Files"]
---

# Get a file by ID

`GET /files/{file_id}`

## Request

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

Returns the details of an existing file. To bulk fetch multiple files by their IDs, use `GET /files?id__in=<ID1>&id__in=<ID2>`.

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

## Path parameters

- `file_id` string, required

## Headers

- `x-monite-version` string, required

## Response `200`

Successful Response

- FileResponse
  - `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.
- `404`: A file with the specified ID was not found.
- `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)
