GetEstimatesForIntent
POST/v1/rides/estimates¶ Description
Fetches fare estimates for a given intent. Returns price, ETA, and product details for all matching products. For business requests, business estimate logic runs only when a user_profile is present in the payer specification of a participant in participant_spec; non-business estimate behavior stays on the existing path.
¶ Request Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| context | ThirdPartyRequestContext | Context of this request | Y |
| participant_spec | ParticipantSpecification | Info of the entities that are participating in an order | Y |
| intent | IntentOneOf | Object capturing the requester’s intent. | Y |
¶ Response Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| ride_estimate | RideEstimate | Estimate response for the ride intent | N |
¶ Errors
| HTTP status | Code | Message |
|---|---|---|
| 422 | ERROR_CODE_VALIDATION_FAILED | Requester field is required but was not found in the request payload. |
| 422 | ERROR_CODE_INVALID_LOCATION_SPEC | Location spec is not valid, for example an origin/destination/via has neither a place id nor a point, or origin and destination resolve to the same point. |
| 422 | ERROR_CODE_INVALID_LOCATION_ID | Location id/provider is invalid |
| 422 | ERROR_CODE_OUTSIDE_SERVICE_AREA | Pickup or one of the destinations is outside the service area. |
| 422 | ERROR_CODE_REGION_NOT_ACCESSIBLE | Requested region is not accessible |
| 422 | ERROR_CODE_INVALID_REQUESTED_TIME_SPEC | Requested time spec is not valid |
| 404 | ERROR_CODE_PARTICIPANT_NOT_FOUND | One or more participants not found [value: “ |
| 403 | ERROR_CODE_INVALID_ENTITY_ACCESS | One or more of the participants are not accessible in the current environment: |
| 422 | ERROR_CODE_PARTICIPANT_BANNED | One of the participant(s) is banned |
| 422 | ERROR_CODE_MAX_JOB_DISTANCE_EXCEEDED | The distance between start and end location exceeds the limit. |
| 422 | ERROR_CODE_PRODUCT_NOT_FOUND | Invalid product id or product not available for the given origin/destination(s) |