Update invoice status
This endpoint allows you to update the status of an existing invoice. Typical actions: mark as paid, sent, cancelled (void), or overdue.
Endpoint
POST https://canadamotorjobs.com/api/v1/{locale}/invoices/update-status
Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
id | string | The invoice identifier | Required |
status | string | The new invoice status (e.g.: paid, sent, void, overdue) | Required |
paid_date | string | Payment date (YYYY-MM-DD HH:MM:SS), if status is paid | Optional if status = paid |
payment_method | string | Payment method (e.g.: credit_card, bank_transfer, stripe_pm_id), if status is paid | No |
transaction_id | string | Payment transaction ID, if status is paid | No |
notes | string | Additional notes on the status change | No |
api_token | string | Your API key | required or bearer token |
Errors
| Code | Message |
|---|---|
| 401 | Unauthorized |
| 404 | Not Found |
| 422 | Unprocessable Entity (e.g.: invalid status, status transition not allowed) |
| 500 | Internal Server Error |