Booking quickstart

Create your first booking in a few steps.

Before you start

Create an account or sign in
Complete onboarding with the Booking integration track
Create an Api-Key from your partner dashboard (plain key shown once)
Copy your base URL from the dashboard

1. Find nearby tractors

curl "$API_BASE/booking-services/tractor/nearby/9.08/7.49/" \
  -H "Authorization: Api-Key $API_KEY"

2. Get tractor details

curl "$API_BASE/booking-services/tractor/99/detail/" \
  -H "Authorization: Api-Key $API_KEY"

3. Create a booking

curl -X POST "$API_BASE/booking-services/booking-agent/service-booking/" \
  -H "Authorization: Api-Key $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tractorId": 99,
    "serviceType": 1,
    "serviceDate": "2026-07-20",
    "landArea": 2.5,
    "areaType": "ha",
    "farmerName": "Test Farmer",
    "farmerPhone": "+2348000000000",
    "gender": 1,
    "latitude": 9.08,
    "longitude": 7.49,
    "farmLocation": "Test Farm",
    "crop": "maize"
  }'

Store the returned bookingID. Use $API_BASE and $API_KEY from your dashboard.

4. Track booking status (poll)

Poll for referral progress until status-change webhooks ship. This is the supported tracking mechanism today.

curl "$API_BASE/booking-services/partner/booking/12345" \
  -H "Authorization: Api-Key $API_KEY"

Replace 12345 with the bookingID from step 3. Requires scope booking:bookings:read. Check bookingStatus in the response and map it to the status table.

Poll on an interval (for example every few minutes) while the booking is in progress.

5. List your bookings (optional)

curl "$API_BASE/booking-services/partner/booking/1/20" \
  -H "Authorization: Api-Key $API_KEY"

See the full Booking API reference for details.

Get started

Tell us what you are building and we will align on API access and telemetry integration.