CLclevergy
Invoices

Get invoices by user ID

Retrieves all invoices associated with a specific user, including those without an uploaded PDF (fileUrl is null in that case).

get/users/{userId}/invoices

Request

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

Path parameters

userIdstring required

ID of the user whose invoices to retrieve

Response

List of invoices 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.