Developer documentation
Car rental and car sales, as an API.
Build car rental and car sales into your travel app, hotel, marketplace or rental company with one integration. Naira payments, a full sandbox, and signed webhooks, with the cars, the checks and the hand-over taken care of.
- Base URL
- https://engine-production-0004.up.railway.app/api/v1
- Format
- JSON over HTTPS
- Auth
- Authorization: Bearer wc_…
What are you building?
- MarketplaceSell rentals as a marketplaceOffer our owners’ cars to your customers. We run the cars, payments and hand-over; you earn a commission on every rental.Read the guide →
- Own fleetRun your own fleetAlready have cars? Use our engine for availability, pricing, payments and bookings, and add cars from your own system.Read the guide →
- SalesSell cars with escrowList cars for sale. The buyer’s money is held in escrow until the car and papers change hands.Read the guide →
How a booking flows
- 1SearchCars free for your customer’s dates, with prices.
- 2QuoteThe exact price, extras and deposit.
- 3BookWe hold the car and return a payment link.
- 4PayThe customer pays; the booking confirms by itself.
- 5WebhookYou get a signed booking.confirmed message.
- 6Hand-overOur agent meets the customer at the airport.
- 7EarnYour commission is released when the rental completes.
Make your first call
Create a business account, copy a test key from your dashboard, and ask the API who you are. Test keys work immediately.
curl "https://engine-production-0004.up.railway.app/api/v1/me" \
-H "Authorization: Bearer wc_test_YOUR_KEY"Everything the API does
| Area | What it is for | Endpoints |
|---|---|---|
| Account | Check your key and see what it is allowed to do. | 1 |
| Locations | The airports where cars are collected and returned, and the terms to show your customers. | 3 |
| Rental cars | Search cars for rent, read a car’s calendar, and list the extras and covers a customer can add. | 5 |
| Rental bookings | Price a trip, book it, manage it, check the customer in, cancel it. | 7 |
| Reviews | What customers say about a car, with its average rating. A customer reviews the car after the rental is returned (or the purchase is complete), and a review counts for that car only. | 2 |
| Cars for sale | Search cars for sale, reserve one with a deposit, and follow the purchase through escrow. | 6 |
| Earnings | Your balance, every commission you earned and the payouts you received. | 3 |
| Events | A record of everything that happened, readable by polling. | 2 |
| Webhooks | Get a signed message the moment something changes. Manage the address, the secret and the delivery log. | 8 |
| Your fleet | For businesses with their own cars (plan: fleet or both): add cars, photos and papers, open rental periods and list cars for sale. | 15 |
| Sandbox | Simulate a customer paying, collecting and returning a car, with a test key. | 2 |
Need a hand?
Quote the requestId from an error and we can find the exact request. Write to developers@waca.com.ng.
An error always looks like this
{ "error": { "code": "unavailable", "message": "This car was just booked by someone else.", "requestId": "req_5c1f0a9e3b7d2c4a81" } }