Authentication
All Hello Tractor API requests require authentication. Create an account or sign in to access your base URLs and keys in the partner dashboard.
All APIs use the same base URL. Your staging and production URLs are shown in the partner dashboard after sign-in — they are not published in this documentation.
API families
| API family | Path prefix | Auth header |
|---|---|---|
| Booking services | /booking-services/ | Authorization: Api-Key <key> |
| Financial services | /payg/lms/ | Authorization: Bearer <key> |
| Marketplace | /v1/ | Authorization: Bearer <key> |
Booking services (Api-Key)
Create an Api-Key in the partner dashboard after booking onboarding. The plain key is shown once.
Booking services
curl "$API_BASE/booking-services/tractor/nearby/9.08/7.49/" \
-H "Authorization: Api-Key $API_KEY"
Financial services & Marketplace (Bearer)
PAYG / Marketplace
curl "$API_BASE/payg/lms/contracts" \
-H "Authorization: Bearer $API_KEY"
Never expose API keys in client-side mobile or browser code. Call Hello Tractor APIs from your backend.
Keys are scoped to the endpoints you are granted during onboarding. If a key is compromised, contact dev@hellotractor.com to rotate it.
Using the SDK
The hello-tractor-sdk accepts an API key at initialization:
import { HTSDK } from 'hello-tractor-sdk'
const sdk = HTSDK.init(process.env.HT_API_KEY)
Financial services use direct HTTP calls today; Marketplace methods are available in the SDK.
Get started
Tell us what you are building and we will align on API access and telemetry integration.