Best Time

Use this endpoint to propose your best available time for a service request.

PUT https://hub.vectorcare.com/openapi/v2.0/requests/{request_id}/best-time/

Request Body

{
  "proposed_agreed_dt": "2025-01-15T15:30:00Z"
}

Field	Type	Description
`proposed_agreed_dt`	string	Proposed pickup time (ISO 8601 UTC)

Example Request

curl -X PUT "https://hub.vectorcare.com/openapi/v2.0/requests/KP-ABCD1234/best-time/" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "proposed_agreed_dt": "2025-01-15T15:30:00Z"
  }'

Response

Success (201 Created)

{}

An empty object indicates your proposed time was submitted successfully.

When to Use

Use this endpoint when:

You’ve received a broadcast request
You can fulfill the request but at a different time than originally requested
You want to propose an alternative pickup time for consideration

The requester will be notified of your proposed time and can:

Accept your proposed time
Counter with a different time
Assign the request to another provider

Flow

1. Receive BROADCAST_RECEIVED webhook
2. Review the requested pickup time
3. If you can do it at a different time, POST to /best-time/
4. Wait for response (via webhook)
   - PROPOSAL_ACCEPTED → You're assigned at your proposed time
   - PROPOSAL_DECLINED → Request may go to another provider