Change Request

Use this endpoint to propose a change to the agreed pickup time after you have accepted a request. The request creator will receive a change request notification and can approve or decline your proposed change.

POST https://hub.vectorcare.com/openapi/v2.0/requests/{request_id}/change-request/

Request Body

{
  "agreed_dt": "2025-01-15T15:30:00Z",
  "change_reason": "Traffic"
}

Field	Type	Description
`agreed_dt`	string	Proposed new pickup time (ISO 8601 UTC)
`change_reason`	string	Reason for the change request (max 450 characters)

Common Change Reasons

The following are common reasons used when requesting a time change:

Equipment Issues
Inappropriate Level of Service
Specialty Personnel Issue
Traffic
Wrong Address
Staffing Issues
HUB Request
Site Request
Responded to 911 call
No Rigs Available
Prior Calls
Change in Availability
Stat Urgent
No Reason Given
Dry Run

Example Request

curl -X POST "https://hub.vectorcare.com/openapi/v2.0/requests/KP-ABCD1234/change-request/" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "agreed_dt": "2025-01-15T15:30:00Z",
    "change_reason": "Traffic"
  }'

Response

Success (200 OK)

{}

An empty object indicates your change request was submitted successfully.

When to Use

Use this endpoint when:

You have already accepted a request
You need to change the agreed pickup time
You want the request creator to approve the new time

The request creator will be notified of your proposed change and can:

Approve your proposed time
Decline your proposed time

Flow

1. Accept a request via /accept/ endpoint
2. Circumstances change and you need a different pickup time
3. POST to /change-request/ with new time and reason
4. Request creator receives notification
5. Wait for webhook response:
   - Approved → CHANGE_REQUEST_ACCEPTED with new agreed_for_time
   - Declined → CHANGE_REQUEST_DECLINED (original time remains)

Webhook Responses

When the request creator responds to your change request, you’ll receive a webhook:

Outcome	Action	What Changed
Approved	`CHANGE_REQUEST_ACCEPTED`	`agreed_for_time` updated to your proposed time
Declined	`CHANGE_REQUEST_DECLINED`	Nothing - original agreed time remains