Skip to main content
curl -X GET "https://api.chargefy.io/v1/files/file_123" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "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"
}
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

​
id
string
required
ID do arquivo (file_*).
curl -X GET "https://api.chargefy.io/v1/files/file_123" \
  -H "Authorization: Bearer {{API_KEY}}"

​
Resposta

200 OK com o objeto file completo. Mesmo shape de POST /v1/files. 
{
  "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"
}

​
Erros comuns

StatuscodeQuando ocorre
404resource_missingArquivo não existe nesta organização (ou foi removido)