The API is written in OpenApi 2.0 format and can be found at https://api.abel.taxi/AbelSwagger.json.

You can use the Swagger UI to explore it in your browser.

Error codes

Download an overview of all error codes as a CSV file.

Api-version header

To ensure our servers do not reply with breaking changes, your client should send with each request a api-version-header. Depending on its value, our servers handle the following replies differently:

Api version >= 20170302

  • Swap RatingForCustomer and RatingForDriver parameters in GetTrips functions (as they were wrongly labeled before)
  • All responses will have the regular format with ErrorCode and ErrorText, als the errors/ exceptions

Api version >= 20170222

  • TripTariff, BookTrip, GetActiveCustomerSchedule, GetTrips and DriverLogOn on pre-booked API.

Api version >= 20170209

Will return new rbs type ErrorCodes on oauth/v2/token:

  • 629 - Invalid username and password combination (with http status code 400)
  • 630 - Missing parameters. “username” and “password” required (with http status code 400)
  • 631 - Undefined OAuth error (with http status code 400)

Api version >= 20170121

The response of a secured tripTariff call will contain payment methods under ['result']['FeasiblePaymentMethods'] instead of ['result']['FeasiblePaymentMethods']['PaymentMethods']].

Api version >= 20161229

Will return new rbs type ErrorCodes on oauth/v2/token:

  • 625 for a non-existing customer (with http status code 400)
  • 626 for a non-existing driver (with http status code 400)
  • 627 for a blocked customer (with http status code 403)
  • 628 for a blocked driver (with http status code 403)

Api version >= 20160619

New ErrorCode 615 for AbelSecureService/ValidateEmail (was previously reported under 612)

Api version >= 20160615

  • HTTP status code 400 instead of 500 in case of error in:
    • AddCustomer
    • GetCustomer
    • UpdateCustomer
    • GetDriver
  • HTTP status code 400 instead of 200 in case of error in GetDriverRoutes
  • Successful response contains parameter ServerTime instead of empty response for ChangePassword
  • Successful response contains parameter ServerTime instead of ServerTime, ErrorText and ErrorCode response for UpdateDevice
  • Successful response contains parameter ServerTime instead of ServerTime, ErrorText and ErrorCode response for ChangeEmail
  • Successful response contains parameter ServerTime instead of version and result response for SendPasswordResetToken
  • Successful response contains parameter ServerTime instead of version and result response for ResetPassword
  • Successful response contains parameter ServerTime instead of version and result response for ValidateEmail

Api version >= 20160602

ErrorCode 629 (Cannot add your own promo code) in AddDiscount if you add your own discount code instead of the general 606

Api version >= 20160520

AddCustomer returns an oauth-token plus the whole customerobject

Api version >= 20160518

Validation email sent to customer as a result of calling AddCustomer contains an abel:// validation link instead of a link validating via the website

Api version >= 20160508

ErrorCode 624 for “Distance less than 100 meters” instead of the general ErrorCode 6 in TripTariff and BookTrip