List Team Dispatches | propelone

curl -G https://https//https/dispatch/team-dispatches \
     -H "{{tenant_key_name}}: X-Tenant-Key" \
     -H "Content-Type: application/json" \
     -d team_id=a3f1c9d2-4b7e-4f8a-9c3d-2e5b7f1a9d8c \
     -d work_order_id=d9f8a7b6-c5e4-4d3f-8a1b-2c7d9e0f4a5b \
     -d crew_status=staffed \
     -d status=active \
     -d dispatched_from=2024-04-01 \
     -d dispatched_to=2024-04-30 \
     -d dispatched_by=f1e2d3c4-b5a6-7890-1234-56789abcdef0 \
     -d sort_by=dispatched_at \
     -d sort_direction=desc \
     -d per_page=15 \
     -d page=1

{
  "dispatches": [
    {
      "team": {
        "name": "Northfield Maintenance Crew",
        "code": "NMC-07",
        "member_count": 8
      },
      "work_order": {
        "uuid": "d9f8a7b6-c5e4-4d3f-8a1b-2c7d9e0f4a5b",
        "work_order_number": "WO-20240415-0012"
      },
      "dispatched_at": "2024-04-15T08:30:00Z",
      "unassigned_at": null,
      "crew_status": "staffed",
      "dispatched_by": "f1e2d3c4-b5a6-7890-1234-56789abcdef0"
    },
    {
      "team": {
        "name": "Eastside Repair Team",
        "code": "ERT-03",
        "member_count": 5
      },
      "work_order": {
        "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "work_order_number": "WO-20240410-0045"
      },
      "dispatched_at": "2024-04-10T14:00:00Z",
      "unassigned_at": null,
      "crew_status": "understaffed",
      "dispatched_by": "f1e2d3c4-b5a6-7890-1234-56789abcdef0"
    }
  ],
  "pagination": {
    "per_page": 15,
    "current_page": 1,
    "total_pages": 3,
    "total_items": 40
  }
}

Filterable, paginated list of team dispatches across the tenant. Default scope is active (unassigned_at IS NULL); pass status=closed for closed dispatches or status=all for both. Each row embeds a team summary (name, code, member count) and work-order identity (uuid, work_order_number).

Query parameters

team_idstringOptional

Optional: Filter to one team - string UUID - “{{team_uuid}}”

work_order_idstringOptional

Optional: Filter to one work order - string UUID - “{{work_order_uuid}}”

crew_statusstringOptional

Optional: Filter by crew status - staffed|understaffed|lead_missing

statusstringOptional

Optional: active (unassigned_at IS NULL) | closed (unassigned_at IS NOT NULL) | all - default “active”

dispatched_fromstringOptional

Optional: Lower bound on dispatched_at - date format Y-m-d

dispatched_tostringOptional

Optional: Upper bound on dispatched_at - date format Y-m-d

dispatched_bystringOptional

Optional: Filter by dispatcher user UUID - string UUID

sort_bystringOptional

Optional: Sort column - dispatched_at|unassigned_at|crew_status - default dispatched_at

sort_directionstringOptional

Optional: Sort direction - asc|desc - default desc

per_pageintegerOptional

Optional: Results per page - integer 1-100 - default 15

pageintegerOptional

Optional: Page number - default 1

Response

Successful response

Headers

Query parameters

Response