> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a File

> Retorna um arquivo pelo ID.

Retorna o objeto `file` pelo ID. Para arquivos privados (ex.: `dispute_evidence`),
a `url` retornada é uma URL assinada com validade de 1 hora — chame este
endpoint de novo quando expirar.

## Autenticação

A API key da própria organização atua diretamente. A API key de plataforma exige o
header `Organization: <organization_id>` apontando para uma organização
conectada ativa.

## Parâmetros de caminho

<ParamField path="id" type="string" required>
  ID do arquivo (`file_*`).
</ParamField>

<RequestExample>
  ```bash cURL theme={}
  curl -X GET "https://api.chargefy.io/v1/files/file_123" \
    -H "Authorization: Bearer {{API_KEY}}"
  ```
</RequestExample>

## Resposta

`200 OK` com o objeto `file` completo. Mesmo shape de
[`POST /v1/files`](/api-reference/files/create#resposta).

<ResponseExample>
  ```json Response 200 theme={}
  {
    "id": "file_123",
    "object": "file",
    "created_at": "2026-05-24T10:14:50Z",
    "filename": "foto.webp",
    "livemode": true,
    "metadata": {},
    "mime_type": "image/webp",
    "purpose": "product_image",
    "size": 184320,
    "updated_at": null,
    "url": "https://storage.chargefy.io/file_123"
  }
  ```
</ResponseExample>

## Erros comuns

| Status | `code`             | Quando ocorre                                          |
| ------ | ------------------ | ------------------------------------------------------ |
| `404`  | `resource_missing` | Arquivo não existe nesta organização (ou foi removido) |