---
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`

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/banking-api.md) · [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardda/banking-api/revisions/ff1aeb3fda8b/schema)