curl --request POST \
  --url https://api.voltview.co.uk/v1/billValidation/validateInvoice \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "filePath": "accounts/123456789/invoices/INV2024001.pdf"
}'

{
  "filePath": "accounts/123456789/invoices/INV2024001.pdf",
  "status": "passed",
  "errors": []
}

Bill Validation

Validate invoice

Validates an invoice against contract data and optional user-provided consumption data. Performs comprehensive validation including consumption matching, meter reading verification, and check against contract.

Validation Rules:

Meter Reading Logic: Current reading must be ≥ previous reading
Contract Matching: Invoice date must fall within contract period
MPAN Matching: At least one MPAN must match between invoice and contract

Data Sources:

Manual uploads from parseInvoice endpoint
Invoices from Supplier Integration system
User-provided consumption and meter reading data

POST

billValidation

validateInvoice

curl --request POST \
  --url https://api.voltview.co.uk/v1/billValidation/validateInvoice \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "filePath": "accounts/123456789/invoices/INV2024001.pdf"
}'

{
  "filePath": "accounts/123456789/invoices/INV2024001.pdf",
  "status": "passed",
  "errors": []
}

Authorizations

Authorization

string

header

required

JWT token obtained from /v1/requestToken endpoint

Body

application/json

Response

200

application/json

Validation completed - may return passed, failed, or pending status

The response is of type object.

Parse contract

API Documentation

Authentication

User

Sites

Emissions

Specific Site

Consumption

Supplier Integration

Bill Validation

Validate invoice

Authorizations

Body

Response