---
title: "file.info"
method: POST
path: "/file.info"
tags: ["File"]
---

# file.info

`POST /file.info`

Retrieve the URL for a file referenced by a public API file handle (candidate files, resumes, offer letters, and signature-request files).

**Please note** that running this with Ashby-generated demo data in an Ashby demo account can result in errors. We would recommend manually creating a test candidate in Ashby when trying out this endpoint.

**Requires the [`candidatesRead`](authentication#permissions-fileinfo) permission.**

## Request body

- FileInfoRequest
  - `fileHandle` string, required — A file handle retrieved from the public API

## Response `200`

Responses from the file.info endpoint

- union
  - FileInfoSuccessResponse
    - `success` true, required
    - `results` object, required
      - `url` string, required — The url of the file
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)