---
title: "Download an Attachment"
method: GET
path: "/v3/grants/{grant_id}/attachments/{attachment_id}/download"
tags: ["Attachments"]
---

# Download an Attachment

`GET /v3/grants/{grant_id}/attachments/{attachment_id}/download`

## Request

- Base URL: `https://api.us.nylas.com`
- URL: `https://api.us.nylas.com/v3/grants/{grant_id}/attachments/{attachment_id}/download`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns and downloads the specified attachment.

## Query parameters

- `query_imap` boolean

## Response `200`

The attached file as a binary stream (`application/octet-stream`). Use the
[Return Attachment Metadata endpoint](/docs/reference/api/attachments/get-attachments-id/)
to get the MIME type of the file.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `429`: Rate limited. The provider or Nylas throttled the request. If a provider throttles a request and says how long to wait, the `Retry-After` header gives that number of seconds. When the header is missing, retry with exponential backoff. See [429 rate limit errors by provider](/docs/api/errors/400-response/#429-rate-limit-errors-by-provider).
- `504`: Provider Failure

## Changes

- **2026-09-26** `763d6b969cd7`: 1 info
  - added the optional property `error/provider_error` to the response with the `429` status

[Operation history](https://skmtc.dev/nylas/apis/nylas-api/changes/v3/grants/:grant_id/attachments/:attachment_id/download/get.md)

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) - [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nylas/apis/nylas-api/revisions/7782a3e3ab70?raw)