---
title: "Get download url for an invoice"
method: GET
path: "/matters/{matterId}/invoices/{invoiceId}/download"
tags: ["Invoices"]
---

# Get download url for an invoice

`GET /matters/{matterId}/invoices/{invoiceId}/download`

## Request

- Base URL: `https://api.smokeball.com`
- URL: `https://api.smokeball.com/matters/{matterId}/invoices/{invoiceId}/download`
- Auth: API key in header `x-api-key` and API key in header `Authorization`

Retrieves download details for a specified invoice.

## Path parameters

- `matterId` string, required
- `invoiceId` string, required

## Response `200`

When request is successful. Returns an 'InvoiceFileInfo' object.

- InvoiceFileInfo
  - `invoiceId` string, nullable: Unique identifier of the requested invoice
  - `versionId` string, nullable: Unique identifier of the invoice version
  - `downloadUrl` string, nullable: Link to download file
  - `expiry` string, date-time: Expiry date/time when the download link is no longer accessible
  - `status` string, nullable: Current status of the invoice

## Other responses

- `400`: When an unsupported request is made.
- `403`: When the requested file does not belong to the account making the request.
- `404`: When invoice with the specified id does not exist.

---

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