Get an access token
Use a Cognito machine client created for one organization. Request only the route scopes the integration needs.
ReadyCar Exchange / API v0.2
Connect vehicles to the physical service network.
One contract for fleet and provider systems plus the ReadyCar SiteMap and ASV mobile apps: supply, demand, facility guidance, completion evidence and settlement orchestration.
First request
Authenticate once. Act for the fleet or provider.
Send an idempotency key
Every mutation carries a unique key, making safe retries the default for vehicle and provider systems.
Follow the event
Correlated platform events can be delivered to registered HTTPS endpoints with timestamped HMAC signatures.
CREATE A SERVICE REQUEST
curl --request POST "$READYCAR_API/v1/service-requests" \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Idempotency-Key: req-9082-charge-20260808" \
--header "Content-Type: application/json" \
--data '{
"vehicle_id": "veh_AV_9082",
"service_items": [{"service_item_id": "rsi_dcfc_ccs1_150kw"}],
"service_window": {
"earliest_start": "2026-08-08T20:00:00Z",
"latest_completion": "2026-08-08T22:00:00Z"
},
"fulfillment_mode": "INSTANT_BOOK"
}'Contract decisions
Built around operational truth.
Commercial and spatial facets
A FacilityResource is both the capacity that is sold and the physical place SiteMap guides the vehicle to.
Total operational cost
Qualified offers rank in currency after travel, time, queue, failure, route and bundle effects—not an opaque blended score.
Soft until award
Bids make bounded soft commitments. The selected resource becomes an exclusive capacity hold only after award.
No competitor-derived signals
Provider rules may use the provider's own utilization and costs. Rival identity, price, capacity and bidder counts are prohibited inputs.
OpenAPI 3.1
API reference
Search the complete POC contract across fleet, provider and platform workflows.
Loading API contract…