---
title: "Get a company file URL"
method: GET
path: "/v1/companies/{id}/file"
tags: ["Company"]
---

# Get a company file URL

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

## Request

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

Returns a short-lived presigned URL for a file stored in Active Storage for
the company (e.g. a KYC document). The attachment is selected by the
**required** `file_name` query parameter, which must be one of the company's
allowed attachment keys. The allowed set depends on the company's country:
for Chile (and other non-MX countries) `tax_folder`, `incorporation_document`,
`registration_certificate`, `power_structure`, `rut_certificate`,
`plh_contract_file`, `plh_kyc_file`, `plh_alliance_file`,
`plh_contract_file_signed`, `plh_kyc_file_signed`, `plh_alliance_file_signed`;
for Mexico (`MX`) `incorporation_document`, `address_file`, `cif_file`,
`majority_ownership_incorporation_file`.

## Path parameters

- `id` string, required

## Query parameters

- `file_name` 'tax_folder' | 'incorporation_document' | 'registration_certificate' | 'power_structure' | 'rut_certificate' | 'plh_contract_file' | 'plh_kyc_file' | 'plh_alliance_file' | 'plh_contract_file_signed' | 'plh_kyc_file_signed' | 'plh_alliance_file_signed' | 'address_file' | 'cif_file' | 'majority_ownership_incorporation_file', required

## 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`: Company not found
- `412`: `file_name` query parameter is missing.
- `422`: The `file_name` is not an allowed attachment key (`attachment/file_name_not_allowed`), the attachment is not present (`attachment/file_not_attached`), or the attachment record exists but its underlying blob is missing from storage (`attachment/blob_missing`).

---

[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)