---
title: "Get file"
method: GET
path: "/core/files/{fileId}"
tags: ["Files"]
---

# Get file

`GET /core/files/{fileId}`

## Request

- Base URL: `https://api.enterprise.sandbox.uphold.com`
- URL: `https://api.enterprise.sandbox.uphold.com/core/files/{fileId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/core/oauth2/token` scopes: `core.files:read`
- TypeScript: <https://skmtc.dev/uphold/apis/core-api/docs/core/files/:fileId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve an existing file by id.

## Path parameters

- `fileId` string, uuid, required

## Headers

- `X-On-Behalf-Of` string
- `X-Uphold-User-Ip` union
  - string, ipv4
  - string, ipv6
- `X-Uphold-User-Agent` string
- `X-Uphold-User-Origin` string
- `X-Uphold-User-Country` string
- `X-Uphold-User-Subdivision` string
- `X-Uphold-User-City` string

## Response `200`

File retrieved.

- object
  - `file` File, required
    - `id` string, uuid, required: The id of the file.
    - `status` 'pending' | 'uploaded', required: The status of the file.
    - `category` string, required: The category of the file.
    - `contentType` string, required: The content type of the file.
    - `download` object: The download information of the file.
      - `url` string, uri, required: The pre-signed URL to download the file.
      - `expiresAt` string, date-time, required: The date and time when the download URL expires.

## Other responses

- `400`: Bad Request.
- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Resource not found.
- `429`: Too Many Requests.

---

[API](https://skmtc.dev/uphold/apis/core-api.md) - [All operations](https://skmtc.dev/uphold/apis/core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/uphold/apis/core-api/revisions/6c663575c57a?raw)