CLclevergy
Invoices

Get invoice by ID

Retrieves the details of a specific invoice by its ID

get/contracts/{contractId}/invoices/{id}

Request

  • Base URL
    https://connect.clever.gy
  • Auth
    API key in header clevergy-api-key

Path parameters

contractIdstring required

ID of the contract for which to retrieve the invoice

idstring required

ID of the invoice to retrieve

Response

Invoice details retrieved successfully

idstring required

Unique identifier of the invoice

issueDatestring date required

Date when the invoice was issued

invoicePeriodFromstring date required

Start of the invoice period

invoicePeriodTostring date required

End of the invoice period

type'ELECTRICITY' | 'GAS' | 'WATER' | 'OTHER' required

Type of the contract

costnumber double required

Total cost of the invoice

contractIdstring required

ID of the contract associated with this invoice

externalIdstring

External identifier for the invoice, used for integration with third-party systems. Unique per Clevergy user; may be reused across different users.

conceptsobject

Additional invoice concepts as key-value pairs

fileUrlstring nullable

Signed URL to access the invoice PDF when available. Null when no file has been uploaded for this invoice.

obtainMethod'REAL' | 'ESTIMATED'

Method in which the invoice is obtained

totalEnergyConsumptionnumber double

Total energy consumption recorded in the invoice in kWh

paymentDatestring date

Date when the invoice was paid

paymentStatus'PENDING' | 'PAID' | 'OVERDUE'

Payment status of the invoice

Example response

{
  "id": "invoice-123",
  "issueDate": "2023-01-15",
  "invoicePeriodFrom": "2023-01-01",
  "invoicePeriodTo": "2023-01-31",
  "type": "ELECTRICITY",
  "cost": 125.5,
  "contractId": "contract-123",
  "externalId": "ext-456",
  "concepts": {
    "energy": "75.20",
    "taxes": "15.30",
    "fixed": "35.00"
  },
  "fileUrl": "https://example.com/invoices/detail/123",
  "obtainMethod": "REAL",
  "totalEnergyConsumption": 350.75,
  "paymentDate": "2023-02-01",
  "paymentStatus": "PAID"
}

Changes

No recorded changes to this operation across all 1 revision of this API.