---
title: "Retrieve an attachment"
method: GET
path: "/v1/attachments/{attachment-id}"
tags: ["Attachments"]
---

# Retrieve an attachment

`GET /v1/attachments/{attachment-id}`

Use the View Attachment REST request to retrieve information about an attachment document.

You can only use this operation if you have a Billing role that includes the Manage Attachments permission.
For more information, see [Billing roles](https://docs.zuora.com?resourceId=platform-billing-roles).
To change your Billing role, contact your Zuora platform administrator.

## Path parameters

- `attachment-id` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- GETAttachmentResponseType
  - `createdBy` string — Zuora user id who added this attachment to the object.
  - `createdOn` string — Date and time when the attachment was added to the object.
  - `description` string — Description of the attachment.
  - `fileContentType` string — File type.
  - `fileId` string — File ID of the attached file. Use this file ID with [Get files](https://developer.zuora.com/api-references/api/operation/GET_Files) to download the file.
  - `fileName` string — Attachment file name.
  - `id` string — Id of this attachment.
  - `organizationLabel` string — The organization that this object belongs to. Note: This field is available only when the Multi-Org feature is enabled.
  - `success` boolean — Returns `true` if the request was processed successfully.
  - `updatedBy` string — Zuora user id who last updated the attachment.
  - `updatedOn` string — Date and time when the attachment was last updated.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

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