Boyasa API documentation

Getting an account

There is currently no self-serve API key. Every request is authenticated with the same JWT-based login used by the Boyasa apps:

1. Register a business account — either through the business dashboard or the registration endpoints described in Authentication.
2. An admin approves the new business account.
3. Log in with POST /auth/login, complete the OTP step, and use the returned accessToken as a Bearer token on every subsequent request.

There is no separate sandbox environment yet — all requests run against the same environment described by ALLOWED_ORIGINS/DATABASE_URL your deployment is configured with.

Your first request

Once you have an access token, fetch nearby drivers for a delivery:

curl -X POST https://api.boyasa.com/api/matching/find-drivers \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pickupLocation": { "lat": 6.5244, "lng": 3.3792 },
    "destinationLocation": { "lat": 6.4550, "lng": 3.3841 },
    "vehicleType": "BIKE",
    "orderType": "PACKAGE_DELIVERY",
    "countryId": "<country-id>",
    "customerId": "<customer-id>"
  }'