---
title: "Fetch an External Link"
method: GET
path: "/files/{file_id}/external_links/{external_link_id}"
tags: ["Files"]
---

# Fetch an External Link

`GET /files/{file_id}/external_links/{external_link_id}`

Fetch a previously created `External Link` resource.

## Headers

- `Finix-Version` string

## Response `200`

A single `External Link`

- ExternalLink
  - `id` string — The ID of the `External Link` resource.
  - `created_at` string, date-time — Timestamp of when the object was created.
  - `duration` integer, nullable — Details how long (in minutes) the `url` is valid for.
  - `expired` boolean — Whether the external link has expired.
  - `expires_at` string, date-time — When the external link expires.
  - `file_id` string — The `File` ID the `External Link` relates to.
  - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`)
  - `type` 'UPLOAD' | 'DOWNLOAD' | 'VIEW' — Sets whether the link uploads or downloads files from Finix.
  - `url` string — The URL that can be used to upload, download, or view the `File`.
  - `user_id` string — The ID of the `user` that requested to create this link.

## Other responses

- `401` — Unauthorized. Authentication is required and has failed or has not been provided.
- `403` — Forbidden. The client is authenticated but does not have permission to access the resource.
- `404` — Not Found. The requested resource could not be found on the server.
- `406` — Not Acceptable. The server could not accept the submitted request. Confirm how the request was formatted and submitted.

---

[API](https://skmtc.dev/finix/apis/finix-api-reference.md) · [All operations](https://skmtc.dev/finix/apis/finix-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finix/finix-api-reference/revisions/0cf4cdf27361/schema)
