List payment batches

GET/payroll/payment-batches

Returns all payment batches for the tenant, including their processing status. Use to track disbursement progress across payroll runs.

Request

This endpoint takes no parameters and no request body.

Responses

200 List of payment batches

Content type application/json, array of object · PaymentBatchV1.

Field	Type	Required	Description
id	integer	No
run_id	integer	No
name	string	No
payment_method	string	No	One of: "bank_transfer", "mobile_money", "cheque", "cash"
status	string	No	One of: "draft", "submitted", "processing", "completed", "failed"
employee_count	integer, nullable	No
total_amount	number (float), nullable	No
currency	string	No	Max length: 3
created_at	string (date-time)	No

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/payroll/payment-batches" \
  -H "Accept: application/json"