Skip to content
/bounty
Sign in
All bounties

Careem

Open
careem.com / app.careem.com

MENA ride-hailing and super-app trip workflows for booking and tracking rides.

Reward
₩500,000
Tier
Platinum
Auth
Browser
APIs
6 APIs
Working now
none
Posted
2026-07-04
Kind
New service
Lifecycle
  1. Open
  2. Claimed
  3. In review
  4. Finalizing
  5. Syncing
  6. Merged
  7. Paid

Scope

This provider targets the unofficial Careem browser or app surface, not a public developer API. It must contend with authenticated trip state, live driver matching, fare estimation, scheduling, cancellation rules, receipts, and support follow-up. The work is medium to hard because ride availability and pricing are dynamic and the surface is often session-bound.

Expected APIs

6
search-ride-optionsSearch ride optionsReadMedium

Compare available Careem ride types for a pickup and dropoff pair, including estimated fare, time, and service class. The operation corresponds to the ride request discovery flow in the app rather than a stable public endpoint.

Inputs
  • pickupobjectRequiredPickup location and optional landmark details.Example {"lat":25.2048,"lng":55.2708}
  • dropoffobjectRequiredDestination location for the ride.Example {"lat":25.1972,"lng":55.2744}
  • ride_timestringOptionalImmediate or scheduled ride timing.Example now
  • car_typestringOptionalPreferred service class such as economy or premium.Example economy
Outputs
ride_optionscurrencyestimated_fareeta_minutesservice_class
Acceptance
  • Returns multiple ride choices or a comparable availability list for the requested route.
  • Includes pricing and ETA context for each available class when the surface provides it.
  • Requires an authenticated session because ride discovery is account-bound.

Auth required for this API.

get-driver-and-pricing-detailsGet driver and pricing detailsReadMedium

Fetch live ETA, matching availability, route summary, cancellation rules, and the pricing breakdown shown before booking.

Inputs
  • ride_option_idstringRequiredIdentifier for the selected ride option.Example ride_opt_001
Outputs
etadriver_availabilityroute_summarypricing_breakdowncancellation_rules
Acceptance
  • Returns the live or near-live ETA and availability details for the selected option.
  • Exposes a route summary and fare breakdown instead of only a single quoted total.
  • Shows cancellation rules or fees before the booking step.

Auth required for this API.

prepare-ridePrepare rideWriteMedium

Build an immediate or scheduled ride draft with pickup notes, passenger details, and timing preferences so the final request can be reviewed before submission.

Inputs
  • pickup_notesstringOptionalAdditional context for finding the pickup point.Example Gate 3 near the taxi stand
  • scheduled_timestringOptionalOptional scheduled pickup time.Example 2026-07-06T18:30:00+04:00
  • passenger_countnumberOptionalNumber of passengers for the ride request.Example 2
Outputs
ride_draft_idpickup_notesscheduled_timeestimated_fareservice_class
Acceptance
  • Creates a draft ride request without dispatching the driver booking immediately.
  • Carries the pickup and timing details through to the review step.
  • Keeps fare and class information visible so the user can confirm the draft.

Auth required for this API.

review-fare-and-safetyReview fare and safetyReadMedium

Show the final fare, payment method, passenger details, and any safety or policy text that appears before booking.

Inputs
  • ride_draft_idstringRequiredPrepared ride draft to inspect.Example draft_abc123
Outputs
final_farepayment_methodpassenger_detailssafety_termsfees
Acceptance
  • Returns the final fare and any extra fees that will apply if the ride is booked.
  • Shows the payment method and passenger identity or rider context associated with the draft.
  • Includes safety or policy language that the app presents before confirmation.

Auth required for this API.

book-or-cancel-rideBook or cancel rideWriteMedium

Submit the ride booking or cancellation only after explicit user approval, using the prepared draft and the latest fare or cancellation state.

Inputs
  • ride_draft_idstringRequiredPrepared ride draft or booking reference.Example draft_abc123
  • actionstringRequiredWhether to book or cancel the ride.Example book
  • user_approvalbooleanRequiredExplicit confirmation from the user for the requested action.Example true
Outputs
trip_idstatusconfirmed_farecancellation_fee
Acceptance
  • Does not book or cancel without explicit approval.
  • Returns the resulting trip identifier or cancellation result together with the confirmed fare or fee.
  • Uses the latest draft state so the outcome matches the review step.

Auth required for this API.

track-trip-and-supportTrack trip and supportReadMedium

Monitor trip status, driver progress, receipts, refunds, and support case references after the booking is underway or completed.

Inputs
  • trip_idstringRequiredTrip or ride identifier to track.Example trip_789
Outputs
trip_statusdriver_statusreceiptrefund_statussupport_case
Acceptance
  • Returns the live or most recent trip status for the requested ride.
  • Includes receipts and refund state when the trip is finished or disputed.
  • Surfaces a support case reference if the app exposes one.

Auth required for this API.

Suggested surface. Propose changes in your submission if the upstream differs.

Acceptance criteria

  • Service scaffolded from the public @apifuse/provider-sdk
  • All listed APIs implemented with Zod/Standard Schema input & output
  • Each API declares exactly one of healthCheck or healthCheckUnsupported
  • Real upstream fixture data included where applicable
  • bun run check and bun run test pass
  • Auth, credential and env-secret behavior documented. No real secrets committed

Evidence to submit

  • Workspace repository and main commit link
  • SDK version/tag and the create command used
  • API list with input/output summaries
  • healthCheck coverage table per API
  • bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace is prepared after confirmation.