# Retrieve a file

`GET https://api.parasend.com/v1/files/{id}`

Source: https://parasend.com/docs/api/files/retrieve

Authentication: `Authorization: Bearer <API key>` (a `ps_test_` key in test mode, `ps_live_` in live mode).

Retrieves a file's details: its name, size and SHA-256.

## Path parameters

- `id` (string, required): The file's ID, starting `fil_`.

## Example: Retrieve a file

```bash
curl "https://api.parasend.com/v1/files/fil_01M6R27SZK99V6N6WG4GK15T6R" \
  -H "Authorization: Bearer $PARASEND_KEY"
```

```js
const res = await fetch('https://api.parasend.com/v1/files/fil_01M6R27SZK99V6N6WG4GK15T6R', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.PARASEND_KEY}`,
  },
});
const data = await res.json();
```

## Response 200

Metadata (name, size, sha256).

```json
{
  "id": "fil_01M6R27SZK99V6N6WG4GK15T6R",
  "object": "file",
  "name": "test-notice.pdf",
  "bytes": 691,
  "sha256": "1b0cff41d97c8dcf92b7de986d66d12fb94e68f6db19821aa4b263dcfb0b6225",
  "created": "2026-11-06T09:15:05.587Z"
}
```

Errors: one shape, `{"error": {type, code, message, param, request_id}}`; every code is listed at https://parasend.com/docs/errors.