---
title: "Get a user file URL"
method: GET
path: "/v1/users/{id}/file"
tags: ["User"]
---

# Get a user file URL

`GET /v1/users/{id}/file`

## Request

- Base URL: `https://api.cardda.com`
- URL: `https://api.cardda.com/v1/users/{id}/file`
- Auth: HTTP bearer

Returns a short-lived presigned URL for a file stored in Active Storage for
the user (e.g. their identification document). Access is gated by the user
file policy (the user themselves, or admins / `companies_manage`). The
specific attachment is selected by the `attachment` query parameter.

## Path parameters

- `id` string, required

## Query parameters

- `attachment` string

## Parameters

- `#/paths/~1v1~1users/get/parameters/0` (unresolved $ref)

## Response `200`

Presigned URL for the requested file.

- object
  - `url` string, uri

## Other responses

- `401`: Unauthorized
- `404`: User or attachment not found

---

[API](https://skmtc.dev/cardda/apis/organization-api.md) - [All operations](https://skmtc.dev/cardda/apis/organization-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cardda/apis/organization-api/revisions/32a4430278a8?raw)