Skip to main content
GET
/
api
/
financial
/
invoices
List invoices
curl --request GET \
  --url https://api.propops.app/api/financial/invoices \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Operation completed successfully",
  "invoices": [
    {
      "id": 1001,
      "uuid": "550e8400-e29b-41d4-a716-446655440001",
      "job_ref": "JOB-001",
      "invoice_no": "INV-001",
      "job_title": "Boiler Service - Unit 001",
      "contractor_name": "Contractor_001",
      "contractor_budget": 180,
      "payment_received_client": 250,
      "payment_sent_contractor": 180,
      "agent_commission_paid": 25,
      "inhouse_commission_paid": 15,
      "status_name": "Invoiced"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

All API requests must include a valid Bearer token in the Authorization header. Tokens are 64-character SHA-256 session hashes issued by the PropOps authentication system.

Example:

Authorization: Bearer a1b2c3d4e5f6...

Query Parameters

​
action
enum<string>
required
Available options:
get_invoices
​
payment_status_id
integer
Example:

1

​
job_status_id
integer
Example:

9

​
limit
integer
default:50

Maximum number of records to return (default 50, max 200).

Required range: 1 <= x <= 200
​
offset
integer
default:0

Number of records to skip for pagination.

Required range: x >= 0

Response

Invoice list

​
success
boolean
Example:

true

​
message
string
Example:

"Operation completed successfully"

​
invoices
object[]