Skip to content

Get invoice delivery history

GET /api/v2/billing/invoices/{id}/email-info

See where an invoice was sent and where it would go now. emails lists up to 20 invoice e-mails for this invoice, newest first. currentTargets holds the current delivery targets for the next invoice e-mail, from the account’s settings. For Swedish organisations, peppol shows the e-invoice delivery and any copies requested with POST /api/v2/billing/invoices/{id}/actions/resend-peppol. Read it again after a resend to follow the copy.

Authentication: An API key with the scope read:billing. About keys and scopes

Request

Path parameters

idstringrequired
Public invoice ID from GET /api/v2/billing/invoices (inv_…).

Example

GET /api/v2/billing/invoices/{id}/email-info
curl "https://cloud.hostup.se/api/v2/billing/invoices/inv_01hxa3b4c5d6e7f8g9h0j1k2m3/email-info" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 Delivery history and current targets.

{
"emails": [
{
"to": "owner@example.com",
"ccRecipients": [
"finance@example.com"
],
"status": "sent",
"deliveryStatus": "delivered",
"sentAt": "2026-04-18T10:00:00.000Z",
"createdAt": "2026-04-18T09:59:00.000Z",
"deliveredAt": "2026-04-18T10:00:02.000Z"
}
],
"account": {
"type": "individual",
"countryCode": "SE"
},
"peppol": {
"available": true,
"delivery": null
},
"currentTargets": {
"to": "billing@example.com",
"ccRecipients": [
"finance@example.com"
]
}
}
Response fields
accountobject or null
Account type and country.
emailsarray of object
tostring
ccRecipientsarray of string
statusstring or null
deliveryStatusstring or null
sentAtstring or null
createdAtstring or null
deliveredAtstring or null
currentTargetsobject or null
peppolobject
availableboolean
deliveryobject or null

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404Not found. The resource does not exist or is not owned by the caller; code is invoice_not_found.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.