Fare Rule
This method is used to get the fare rules and condition of a specific flight option. It contains the fare basis code and the relevant details associated with it, such as restrictions and penalties(cancellation fees).
Service URL (REST) to be used:
Fare Rule Request
| Level | Element | Format | Comments | Mandatory |
|---|---|---|---|---|
| 1 | EndUserIp | String | Public IP address of the end user initiating the flight search request. Used for security, tracking, and compliance purposes. | Mandatory |
| 2 | ClientId | String | Unique client identifier assigned to the agency during API registration and onboarding. | Mandatory |
| 3 | UserName | String | API username assigned to the agency for authentication and authorization. | Mandatory |
| 4 | Password | String | API password assigned to the agency for authentication. This credential must be transmitted securely. | Mandatory |
| 5 | SrdvType | String | Identifier representing the response type or data version returned by the SRDV system. Used internally to classify and process search results. | Mandatory |
| 6 | SrdvIndex | String | Unique SRDV reference identifier associated with the selected flight result. Required for subsequent operations such as fare validation, booking, and ticket issuance. | Mandatory |
| 7 | TraceId | String | Trace ID returned in the search response. This value must be echoed back in subsequent requests and can be used to trace a specific search or booking at the SRDV system. | Mandatory |
| 8 | ResultIndex | String | Unique identifier of the selected flight result returned in the search response. This value is required for Fare Quote, Booking, and other follow-up API operations. | Mandatory |
Fare Rule Response
| Level | Element | Format | Comments | Mandatory |
|---|---|---|---|---|
| 1 | Error{} | Object | Contains error details returned by the API when the request cannot be processed successfully. | Mandatory |
| 1.1 | ErrorCode | Integer | Unique error code identifying the type of error encountered during request processing. | Mandatory |
| 1.2 | ErrorMessage | String | Human-readable description of the error returned by the API. ( Will contain error description to ErrorCode. Error Message would be blank in case ErrorCode =0 ) | Mandatory |
| 2 | SrdvType | String | Response type identifier indicating the version or category of data returned by the SRDV system. | Mandatory |
| 3 | ResultIndex | String | Unique identifier returned by the search response. Required for fare validation, pricing, and booking operations. | Mandatory |
| 4 | TraceId | String | Trace ID returned in the search response. This value can be used to trace a specific search or booking at the SRDV system. | Mandatory |
| 5 | SpecialRule | String | Additional airline-specific terms, restrictions, or special conditions applicable to the selected fare. May include promotional fare restrictions, baggage limitations, or ticketing conditions. | Optional |
| 6 | Results[] | Array | Collection of fare rule records associated with the selected flight itinerary. | Mandatory |
| 6.1 | Airline | String | IATA airline code or airline name to which the fare rule applies. | Mandatory |
| 6.2 | Origin | String | IATA airport or city code representing the departure location for which the fare rule is applicable. | Mandatory |
| 6.3 | Destination | String | IATA airport or city code representing the arrival location for which the fare rule is applicable. | Mandatory |
| 6.4 | FareBasisCode | String | Airline-defined fare basis code identifying the specific fare type, booking class, and fare conditions associated with the ticket. | Mandatory |
| 6.5 | FareRuleDetail | String | Detailed fare conditions provided by the airline, including cancellation policies, rescheduling charges, refund eligibility, no-show penalties, baggage rules, and other applicable restrictions. | Mandatory |