Request List (Partial Details)

Returns a list of partial request details matching your query criteria.

GET https://api.vectorcare.com/openapi/v1.0/requests/

Note: URLs must include the trailing slash.

Query Parameters

Parameter	Type	Description
`date__gte`	integer	Unix epoch timestamp, filter requests on or after this time. Default: Now - 24h
`date__lte`	integer	Unix epoch timestamp, filter requests on or before this time. Default: Now + 24h
`request__state`	string	Filter by state: `accepted`, `completed`, `canceled`. Default: `accepted`

Response

Success (200 OK)

[
  {
    "id": "ETMBWYYD",
    "state": "accepted",
    "created_timestamp_utc": "2021-01-11T22:19:01Z",
    "event_dt_utc": "2021-01-13T19:00:00Z",
    "last_updated_timestamp_utc": "2021-01-13T18:48:55Z"
  },
  {
    "id": "ABC12345",
    "state": "accepted",
    "created_timestamp_utc": "2021-01-12T10:30:00Z",
    "event_dt_utc": "2021-01-14T08:00:00Z",
    "last_updated_timestamp_utc": "2021-01-13T15:22:10Z"
  }
]

Response Fields

Field	Type	Description
`id`	string	VectorCare’s unique request ID
`state`	string	Current state of the request
`created_timestamp_utc`	string	When the request was created (ISO 8601 UTC)
`event_dt_utc`	string	Event datetime based on: Agreed Time > Requested Time > Created Time
`last_updated_timestamp_utc`	string	Last modification time (ISO 8601 UTC)

Results are returned in ascending order by event_dt_utc.

Error (401 Unauthorized)

{
  "message": "Authentication credentials were not provided.",
  "code": "members:not_authenticated"
}

Usage Pattern

Call this endpoint to get a list of request IDs
Use the Request Detail endpoint to fetch full details for each ID
Store the last_updated_timestamp_utc to detect changes on subsequent polls