Managing Invoices

Invoices track payments between you, your subcontractors, and your clients.

List Invoices

curl https://beta.renovatr.app/api/v1/projects/1/invoices \
  -H "X-API-KEY: your-api-key-here"

Get an Invoice

curl https://beta.renovatr.app/api/v1/projects/1/invoices/5 \
  -H "X-API-KEY: your-api-key-here"

Create an Invoice

curl -X POST https://beta.renovatr.app/api/v1/projects/1/invoices \
  -H "X-API-KEY: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "invoiceNumber": "INV-001",
    "subcontractorId": 3,
    "amount": 2500,
    "status": "pending",
    "dateIssued": "2026-03-01",
    "dateDue": "2026-03-31"
  }'

Fields

Field	Type	Required	Description
invoiceNumber	string	Yes	Invoice reference number
subcontractorId	integer	No	Subcontractor this invoice is from
amount	number	Yes	Invoice amount
status	string	No	pending, received, sent_to_client, or client_paid
dateIssued	string	No	ISO date string
dateDue	string	No	ISO date string
notes	string	No	Additional notes

Invoice Statuses

Status	Description
pending	Invoice created but not yet received
received	Invoice received from subcontractor
sent_to_client	Invoice forwarded to client for payment
client_paid	Client has paid the invoice

Update an Invoice

curl -X PATCH https://beta.renovatr.app/api/v1/projects/1/invoices/5 \
  -H "X-API-KEY: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{ "status": "client_paid" }'

Delete an Invoice

curl -X DELETE https://beta.renovatr.app/api/v1/projects/1/invoices/5 \
  -H "X-API-KEY: your-api-key-here"

note

Viewing invoices requires the canViewInvoices permission. Viewing invoice amounts also requires canViewFinancials.