> ## Documentation Index
> Fetch the complete documentation index at: https://sendcloud.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Retrieve an invoice
> Retrieve a single invoice by id.
This endpoint is currently in **beta**. Its shape may change in backwards-incompatible ways while we collect feedback.
## OpenAPI
````yaml /.openapi/v3/invoices/openapi.yaml get /invoices/{invoice_id}
openapi: 3.1.0
info:
title: Invoices API
version: 3.0.0
contact:
name: Sendcloud API Support
url: https://www.sendcloud.dev
email: contact@sendcloud.com
description: >-
The Invoices API lets you retrieve the invoices issued to your Sendcloud
account, including subscription and transactional invoices.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://panel.sendcloud.sc/api/v3
description: Sendcloud Production
security: []
tags:
- name: Invoices
description: An invoice issued to your Sendcloud account.
paths:
/invoices/{invoice_id}:
parameters:
- schema:
type: integer
in: path
name: invoice_id
description: The id of the invoice.
required: true
get:
tags:
- Invoices
summary: Retrieve an invoice
description: |-
Retrieve a single invoice by id.
This endpoint is currently in **beta**. Its shape may change in backwards-incompatible ways while we collect feedback.
operationId: sc-public-v3-scp-get-invoice
responses:
'200':
description: OK
content:
application/json:
schema:
description: Retrieve invoice
type: object
properties:
data:
$ref: '#/components/schemas/invoice'
required:
- data
examples:
RetrieveInvoice:
summary: Retrieve an invoice
value:
data:
id: 5501
reference: INV-2026-000123
created_at: '2026-05-31T00:00:00Z'
due_date: '2026-06-30T00:00:00Z'
price_taxable:
value: '1240.5000'
currency: EUR
price_non_taxable:
value: '0.0000'
currency: EUR
tax:
value: '260.5050'
currency: EUR
description: Shipping charges — May 2026
category: transactional
issuer:
business_name: Sendcloud B.V.
address: Stationsplein 32
postal_code: 5611 AC
city: Eindhoven
country_name: Netherlands
vat_id: NL852587582B01
coc_id: '57500015'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/errors'
examples:
Unauthorized:
summary: Missing or invalid credentials
value:
errors:
- detail: Authentication credentials were not provided.
status: '401'
code: not_authenticated
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/errors'
examples:
NotFound:
summary: Invoice not found
value:
errors:
- detail: Not found.
status: '404'
code: not_found
'429':
description: Throttled
security:
- HTTPBasicAuth: []
- OAuth2ClientCreds: []
components:
schemas:
invoice:
title: Invoice
description: An invoice issued to your Sendcloud account.
type: object
properties:
id:
type: integer
format: int64
minimum: 1
description: Unique identifier of the invoice.
reference:
type: string
description: Human-readable reference for the invoice.
created_at:
type: string
format: date-time
description: Date the invoice was created.
due_date:
type:
- string
- 'null'
format: date-time
description: Date by which the invoice is due. Null if no due date applies.
price_taxable:
oneOf:
- $ref: '#/components/schemas/price'
- type: 'null'
description: >-
Total taxable amount on the invoice. Null if there is no taxable
amount.
price_non_taxable:
oneOf:
- $ref: '#/components/schemas/price'
- type: 'null'
description: >-
Total non-taxable amount on the invoice. Null if there is no
non-taxable amount.
tax:
$ref: '#/components/schemas/price'
description:
type: string
description: Human-readable description of the invoice.
category:
type: string
description: Category of the invoice.
enum:
- subscription
- transactional
issuer:
oneOf:
- $ref: '#/components/schemas/issuer'
- type: 'null'
description: >-
The Sendcloud subsidiary that issued the invoice. Null if the issuer
is unknown.
required:
- id
- reference
- created_at
- due_date
- price_taxable
- price_non_taxable
- tax
- description
- category
- issuer
errors:
title: Errors
type: object
description: A standardized format for errors in JSON:API responses.
properties:
errors:
type:
- array
- object
items:
type: object
allOf:
- $ref: '#/components/schemas/ErrorObject'
required:
- status
- code
- detail
price:
title: Price
description: >-
A money amount exposed at full database precision (up to 4 decimal
places).
Note: this representation uses 4-decimal precision (unlike the canonical
2-decimal Price model used elsewhere in the v3 API) because invoice
amounts
are stored at the precision used by Sendcloud's billing engine.
type: object
properties:
value:
type: string
description: Monetary amount as a decimal string, with up to 4 decimal places.
example: '12.3456'
currency:
type: string
description: ISO 4217 currency code.
example: EUR
required:
- value
- currency
issuer:
title: Issuer
description: The Sendcloud subsidiary that issued the invoice.
type: object
properties:
business_name:
type: string
description: Legal business name of the issuing Sendcloud entity.
address:
type: string
description: Street address of the issuing entity.
postal_code:
type: string
description: Postal code of the issuing entity.
city:
type: string
description: City of the issuing entity.
country_name:
type: string
description: Country of the issuing entity.
vat_id:
type: string
description: VAT identification number of the issuing entity.
coc_id:
type: string
description: Chamber of commerce identifier of the issuing entity.
required:
- business_name
- address
- postal_code
- city
- country_name
- vat_id
- coc_id
ErrorObject:
title: Error
type: object
description: Error in a JSON:API error format
properties:
id:
type: string
description: A unique identifier for the error.
links:
type: object
description: >-
A set of hyperlinks that provide additional information about the
error.
properties:
about:
type: string
description: A URL that provides additional information about the error.
status:
type: string
format: int32
description: The HTTP status code of the error.
minLength: 1
code:
type: string
description: A unique error code for the error, in snake case format.
minLength: 1
enum:
- unknown_field
- invalid
- forbidden
- invalid_choice
- min_value
- 'null'
- not_found
- required
- not_a_list
- non_field_errors
- authentication_failed
- validation_error
- parcel_announcement_error
title:
type: string
description: A short, human-readable summary of the error.
minLength: 1
detail:
type: string
description: A human-readable explanation of the error.
minLength: 1
source:
type: object
description: >-
An object that identifies the source of the error within the request
payload.
properties:
pointer:
type: string
description: >-
A `JSON` pointer to the location of the error within the request
payload.
parameter:
type: string
description: The name of the `query` parameter that caused the error.
header:
type: string
description: The name of the `header` parameter that caused the error.
meta:
type: object
description: Additional metadata about the error.
securitySchemes:
HTTPBasicAuth:
type: http
description: >-
Basic Authentication using API key and secrets is currently the main
authentication mechanism.
scheme: basic
OAuth2ClientCreds:
type: oauth2
description: >-
OAuth2 is a standardized protocol for authorization that allows users to
share their private resources stored on one site with another site
without having to provide their credentials. OAuth2 Client Credentials
Grant workflow. This workflow is typically used for server-to-server
interactions that require authorization to access specific resources.
flows:
clientCredentials:
tokenUrl: https://account.sendcloud.com/oauth2/token/
scopes:
api: Default OAuth scope required to access Sendcloud API.
````