---
title: "Get a presigned URL to download an outreach attachment"
method: GET
path: "/facility-credentialing-outreaches/attachments/{attachmentId}/download"
tags: ["Facility Credentialing Outreach Resource"]
---

# Get a presigned URL to download an outreach attachment

`GET /facility-credentialing-outreaches/attachments/{attachmentId}/download`

Returns a time-limited presigned Google Cloud Storage URL for downloading a single email attachment; it does not stream the file bytes directly. Call it after retrieving a facility outreach's detail via GET /facility-credentialing-outreaches/{outreachId}/details - the attachmentId to supply is found in that response's emails[].attachments[].id (or emails[].replies[].attachments[].id for reply attachments). tenant-id scopes the lookup; attachmentId must belong to an outreach visible to that tenant. The returned URL is valid for 1 hour from generation.

## Path parameters

- `attachmentId` string, required

## Headers

- `tenant-id` string, required

## Response `200`

The presigned download URL and its metadata: url (the presigned GCS URL), expiresIn (validity in hours, currently always 1), expiresAt (Unix millisecond expiry timestamp), and fileName (the original attachment file name).

- AttachmentDownloadResponse — Response containing presigned URL for downloading email attachment
  - `url` string — Presigned URL for downloading the attachment
  - `expiresIn` integer — Number of hours until the URL expires
  - `expiresAt` integer — Unix timestamp when the URL expires
  - `fileName` string — Original filename of the attachment

## Other responses

- `401` — The request has no valid authentication token.
- `403` — The caller lacks the credentialing-outreach:read permission required to download outreach attachments.
- `404` — No attachment record exists for attachmentId, or the record exists but its underlying file is missing from GCS. The response body does not distinguish between these two causes - both examples below are returned as this same 404.
- `500` — An unexpected error occurred while generating the presigned download URL.

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)