Get fare estimate | Fery × DMRC API Docs

curl -X POST https://uat.feryrides.co.in/ride/fare-estimate \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "pickupLocation": {
    "lat": 28.459119,
    "lng": 77.072912,
    "address": "Metro Station Exit A"
  },
  "dropLocation": {
    "lat": 28.475482,
    "lng": 77.088265,
    "address": "Destination"
  }
}'

{
  "statusCode": 200,
  "success": true,
  "message": "Fare details and ETA fetched successfully.",
  "data": {
    "code": "FARE_CALCULATED",
    "requestId": "1717235676225158",
    "rideTime": 8,
    "timeUnit": "minute",
    "rideDistance": 2.1,
    "distanceUnit": "km",
    "quotes": [
      {
        "totalAmount": 52,
        "dynamicSurge": 0,
        "perKM": 8,
        "perMin": 0,
        "serviceType": "scooty",
        "staticSurge": 0,
        "eta": 10,
        "fareBreakup": {
          "platformFee": 0.98,
          "platformFeeGst": 0.05,
          "price": 49,
          "discountedPrice": 49,
          "fareGst": 2.45,
          "totalFare": 52,
          "discountApplied": "0 %",
          "discountName": "No Discount"
        }
      },
      {
        "totalAmount": 98,
        "dynamicSurge": 0,
        "perKM": 14,
        "perMin": 0,
        "serviceType": "cab",
        "staticSurge": 0,
        "eta": 10,
        "fareBreakup": {
          "platformFee": 1.96,
          "platformFeeGst": 0.1,
          "price": 98,
          "discountedPrice": 98,
          "fareGst": 4.9,
          "totalFare": 98,
          "discountApplied": "0 %",
          "discountName": "No Discount"
        }
      }
    ]
  }
}

Returns fare quotes and ETA for a pickup/drop pair.

Omit serviceType to receive both scooty and cab quotes.
Pass serviceType: "scooty" or "cab" to filter.
Distance and duration are calculated server-side.

Returns fare quotes and ETA for a pickup/drop pair. - Omit `serviceType` to receive **both** `scooty` and `cab` quotes. - Pass `serviceType: "scooty"` or `"cab"` to filter. - Distance and duration are calculated server-side.

Authentication

x-api-keystring

API key provided by Fery for DMRC integration.

Request

This endpoint expects an object.

pickupLocationobjectRequired

dropLocationobjectRequired

serviceTypeenum or list of enumsOptional

Omit to receive both scooty and cab quotes.

Response

Fare calculated successfully

statusCodeintegerOptional

successbooleanOptional

messagestringOptional

dataobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error