---
title: "Retrieve attachment"
method: GET
path: "/attachments/{attachmentId}"
tags: ["attachments"]
---

# Retrieve attachment

`GET /attachments/{attachmentId}`

Use this method to retrieve the details of an attachment.  

To retrieve the details of an attachment you need its attachmentId. Our gateway returned the attachmentId in the response of the [Upload Attachment to Processing Account](https://docs.payroc.com/api/schema/boarding/processing-accounts/upload-to-processing-account) method.  

Our gateway returns information about the attachment, including its upload status and the entity that the attachment is linked to. Our gateway doesn't return the file that you uploaded.

## Path parameters

- `attachmentId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Successful request. Returns the attachment.

- Attachment
  - `attachmentId` string, required — Unique identifier that our gateway assigned to the attachment.
  - `type` 'bankingEvidence' | 'questionnairesAndLicenses' | 'merchantStatements' | 'taxDocuments' | 'mpaOrAmendment' | 'proofOfBusiness' | 'financialStatements' | 'personalIdentification' | 'other', required — Type of attachment.
  - `uploadStatus` 'pending' | 'accepted' | 'rejected', required — Upload status of the attachment. The value is one of the following: - `pending` - We have not yet uploaded the attachment. - `accepted` - We have uploaded the attachment. - `rejected` - We rejected the attachment.
  - `fileName` string, required — Name of the file.
  - `contentType` string, required — Content type of the file.
  - `description` string — Short description of the attachment.
  - `entity` AttachmentEntity, required — Object that contains information about the entity that the attachment is linked to.
    - `type` 'processingAccount', required — Type of entity that the attachment is linked to.
    - `id` string, required — Unique identifier of the entity that the attachment is linked to.
  - `createdDate` string, date-time, required — Date and time that we received your request to upload the attachment.
  - `lastModifiedDate` string, date-time, required — Date and time the attachment was last modified.
  - `metadata` object — Object that you can send to include custom metadata in the request.

## Other responses

- `400` — Invalid request
- `401` — Identity could not be verified
- `403` — Do not have permissions to perform this action
- `404` — Resource not found
- `406` — Not acceptable
- `500` — An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) · [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)