Skip to main content
GET
/
api
/
jobs
/
manage
List or retrieve jobs
curl --request GET \
  --url https://api.propops.app/api/jobs/manage \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "ID": 1001,
    "uuid": "550e8400-e29b-41d4-a716-446655440001",
    "job_ref": "JOB-001",
    "job_title": "Boiler Service - Unit 001",
    "job_description": "Annual boiler service required for property unit 001.",
    "status_id": 1,
    "status_name": "Open",
    "priority_id": 2,
    "priority_name": "Medium",
    "job_type_id": 3,
    "job_type_name": "Gas & Heating",
    "agent_id": 10,
    "agent_name": "Agent_001",
    "contractor_id": 20,
    "contractor_name": "Contractor_001",
    "address_id": 5,
    "full_address": "1 Example Street, Sample Town, EX1 1AA",
    "job_total_budget": 250,
    "contractor_budget": 180,
    "vat_percentage": 20,
    "total_amount": 216,
    "date_works_start_date": "2024-06-01",
    "date_works_end_date": "2024-06-02",
    "invoice_no": "INV-001",
    "quote_no": "QT-001",
    "works_order_ref": "WO-001",
    "access_details": "Key safe code 1234.",
    "is_pinned": false,
    "photos_count": 3,
    "documents_count": 1,
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-06-01T14:00:00Z"
  },
  "count": 42
}

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:
list,
get,
get_file_types,
get_creators,
get_job_agents,
get_job_contractors,
get_job_clients,
list_commits,
get_assignment_notification_state,
preview_delete
uuid
string<uuid>

Job UUID (required for action=get)

Example:

"550e8400-e29b-41d4-a716-446655440001"

Example:

"boiler service"

status_id
integer
Example:

1

priority_id
integer
Example:

2

agent_id
integer
Example:

10

contractor_id
integer
Example:

20

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

Successful response

success
boolean
Example:

true

message
string
Example:

"Operation completed successfully"

data
object
count
integer
Example:

42