---
title: "Get a file by ID"
description: "Returns a stored file."
canonical: "https://docs.printags.com/get-a-file-by-id/"
last_updated: "2026-11-16"
---

# Get a file by ID

`GET /v2/accounts/{accountId}/files/{fileId}`

Returns a stored file. This route does not check the API key.

## Authentication

None: this route answers without an API key.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `accountId` | path | string | yes | Unique identifier of the account |
| `fileId` | path | string | yes | Unique identifier of the file |

## Responses

| Status | Description |
| --- | --- |
| 200 | Successfully retrieved file details |
| 404 | File not found |
| 500 | Server error |

### 200 response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no |  |
| `file` | object | no |  |
| `file.id` | string | no |  |
| `file.name` | string | no |  |
| `file.size` | number | no |  |
| `file.createdAt` | string (date-time) | no |  |

```json
{
  "success": true,
  "file": {
    "id": "987e6543-e21a-11d4-a789-0242ac120002",
    "name": "example.pdf",
    "size": 1024,
    "createdAt": "2024-07-01T09:26:55.737Z"
  }
}
```

## Example

```bash
curl -X GET "https://api.printags.com/v2/accounts/123e4567-e89b-12d3-a456-426614174000/files/987e6543-e21a-11d4-a789-0242ac120002"
```
