Get Public Invoice

Public invoice details — no auth required.

GET /api/v1/public/invoices/{invoice_id}

Get Public Invoice

cURL

curl --request GET \
  --url https://api.hevn.finance/api/v1/public/invoices/{invoice_id}

import requests

url = "https://api.hevn.finance/api/v1/public/invoices/{invoice_id}"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.hevn.finance/api/v1/public/invoices/{invoice_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": 123,
  "currency": "<string>",
  "items": [
    {
      "name": "<string>",
      "quantity": 123,
      "price": 123
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "comment": "<string>",
  "invoiceNumber": "<string>",
  "issuedDate": "2023-12-25",
  "dueDate": "2023-12-25",
  "client": {
    "email": "<string>",
    "displayName": "<string>",
    "address": {
      "streetAddress": "<string>",
      "addressLine2": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zip": "<string>"
    }
  },
  "contractor": {
    "email": "<string>",
    "displayName": "<string>",
    "address": {
      "streetAddress": "<string>",
      "addressLine2": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zip": "<string>"
    }
  },
  "paymentMethods": [],
  "contract": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "documentName": "<string>",
    "documentLink": "<string>"
  },
  "invoiceLink": "<string>",
  "documents": []
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Path Parameters

invoice_id · string<uuid> · required

Response

200

application/json

Successful Response

id · string<uuid> · required

amount · number · required

currency · string · required

status · enum<string> · required

Invoice status.

Available options: draft, sent, paid, cancelled, client_paid, client_declined

items · PublicInvoiceItem · object[] · required

Show child attributes

createdAt · string<date-time> · required

comment · string | null

invoiceNumber · string | null

issuedDate · string<date> | null

dueDate · string<date> | null

client · InvoiceParticipant · object | null

Minimal participant info for invoice response.

Show child attributes

contractor · InvoiceParticipant · object | null

Minimal participant info for invoice response.

Show child attributes

paymentMethods · (IBANAccountDetails · object | USExternalAccountDetails · object | SwiftAccountDetails · object | ContactWalletResponse · object | EmailAccountInput · object)[]

IBAN (SEPA) external account.

IBANAccountDetails

USExternalAccountDetails

SwiftAccountDetails

ContactWalletResponse

EmailAccountInput

Show child attributes

contract · PublicInvoiceContractInfo · object | null

Show child attributes

invoiceLink · string | null

documents · InvoiceDocumentInfo · object[]

Show child attributes