Get invoice attachment

Retrieves a specific invoice attachment by its ID.

get

Depending on the Accept header, returns metadata (application/json) or downloads the file. For external attachments (ERP PDFs), returns file content directly; for internal attachments, returns 301 redirect.

Path parameters

idstringRequired

The ID of the invoice attachment to retrieve.

invoiceIdstringRequired

Query parameters

selectstringOptional

Optional select statement to specify which fields to include in the response.

Responses

200

OK

application/json

Represents an attachment associated with an invoice in the billing system.

revisioninteger · int32Optional

namestringOptional

Name of the attachment.

Example: raw records data

typestring · enumOptional

Represents the type of billing attachment.

Possible values:

filenamestringOptional

Represents the name of the file associated with the attachment.

Example: invoice.pdf

sizeinteger · int64 · nullableOptional

Indicates the size of the file in bytes.

Example: 102400

contentTypestringOptional

Represents the MIME type of the file content.

Example: application/pdf

descriptionstringOptional

Provides a description of the attachment.

Example: Invoice for March 2025

isDeletedbooleanOptional

Indicates whether the attachment has been marked as deleted.

Example: false

idstringOptional

The unique identifier of the attachment.

Example: INA-1234-1234

isExternalbooleanOptional

Indicates whether the attachment is stored externally

301

Moved Permanently

404

Not Found

application/json

406

Not Acceptable

application/json

get

/public/v1/billing/invoices/{invoiceId}/attachments/{id}

HTTPcURLJavaScriptPython

GET /public/v1/billing/invoices/{invoiceId}/attachments/{id} HTTP/1.1
Host: api.platform.softwareone.com
Accept: */*

{
  "audit": {
    "created": {
      "at": "2026-06-12T19:49:16.898Z",
      "by": "[Circular Reference]"
    },
    "updated": {
      "at": "2026-06-12T19:49:16.898Z",
      "by": "[Circular Reference]"
    }
  },
  "$meta": {
    "omitted": [
      "text"
    ]
  },
  "revision": 1,
  "name": "raw records data",
  "type": "Input",
  "filename": "invoice.pdf",
  "size": 102400,
  "contentType": "application/pdf",
  "description": "Invoice for March 2025",
  "isDeleted": false,
  "id": "INA-1234-1234",
  "invoice": {
    "revision": 1,
    "id": "INV-123-456-789"
  },
  "isExternal": true
}