---
title: "Retrieve a file"
description: "One file, by id."
url: "https://openemail.uk/docs/api/files/get"
area: "API"
category: "Mailbox"
---

# Retrieve a file

One file, by id.

`GET /files/{id}`

## GET /files/{id}

One file, by id.

## Example

Needs `threads:read`.

**curl**

```
curl "$OE/files/file_6bb640f5b99e47deb758f1f5" -H "$AUTH"
```

**Response**

```
{
  "object": "file",
  "id": "file_6bb640f5b99e47deb758f1f5",
  "filename": "invoice-0912.pdf",
  "mimeType": "application/pdf",
  "sizeBytes": 184233,
  "direction": "inbound",
  "threadId": "thread_2f9b…",
  "messageId": "<CAF7x…@mail.gmail.com>",
  "deliveredTo": "billing@acme.com",
  "createdAt": "2026-09-12T08:41:03.000Z"
}
```

> A deleted file, one outside the addresses a narrowed key holds, and an unknown id all answer 404.