Error Handling

Whilst every effort will be made to capture all errors which may be returned for these API resources on this page, if you are returned an error not recorded here, please provide details to RDG, including the request which generated the error and the error message itself, and we will investigate and add to this page.

Platform Error Format

The Developer Portal will return an error if submitted requests do not comply with one or more of an API's policies. A common example of this is the security policy, which requires a valid JWT in every request. If the request doesn't include a valid JWT then the Portal will reject the request immediately and make no attempt to process it. Rejected requests of this nature will result in a platform error, which has the following simple format (See Platform Error Object data type):

{
    "error" : "error message"
}

RDG Error format

If a request passes the policy checks it will be submitted to the relevant RDG API which may then result in an RDG specific error as opposed to a generic platform error. APIs on the RDG Developer Portal use the following common error format to contain and return these errors to consumers (See RDG Error Object data type):

{
    "errors": [
        {
            "code": "error_code",
            "message": "error message",
            "timestamp": "YYYY-MM-DDTHH:MM:SS",
            "context":
            {
                "{key}": "value"
            }
        }
    ]
}

The context object is an unspecified list of key value pairs, allowing new context information to be provided without requiring a schema change.

Known Error Cases

General

Code	Message	Comment
GBR-AUTH-2000	Security Error	When RDG fails to process request due to client side or server side security failure
GBR-AUTH-2001	Unauthorised User	When user’s token is invalid
GBR-AUTH-2002	Security validation: precondition failed	-
GBR-AUTH-2003	Security validation: Bad request	When request payload has failed to process
GBR_EXCEPTION_0000	Unknown Error	Catch all for any unknown errors
GBR_EXCEPTION_0001	Undefined error by 3rd party system	Unknown error from 3rd party APIs
GBR_EXCEPTION_3000	Invalid schema/ Invalid payload	Bad request due to payload not conforming to the json/xml schema definition
GBR_EXCEPTION_3001	Internal Error	Unable to complete operation
GBR_EXCEPTION_3006	Resource not found	When API resource request is not found or not defined in the specification
GBR_EXCEPTION_3007	Method not allowed	When API resource request doesn’t conform to the API specfication e.g. method GET is expected for a resource but POST or PUT call is made
GBR_EXCEPTION_3009	Unsupported media type	When API resource request media type (e.g. application/json) doesn’t conform to the expected media type
GBR_EXCEPTION_3010	HTTP too many requests	Rate-limit exceeded
GBR_EXCEPTION_3011	AWS S3 bad request error	When AWS S3 throws error due to processing error of the request
GBR_EXCEPTION_3012	Invalid schema/ Invalid payload	Bad request due to payload not conforming to the json/xml schema definition
GBR_EXCEPTION_3013	Invalid schema/ Invalid payload	Bad request due to payload not conforming to the json/xml schema definition
GBR_EXCEPTION_3014	Forbidden Error	When source system doesn’t allow access to a particular resource for a specfic client
GBR_EXCEPTION_3015	Validation Error [Email is valid]	The structural conformation of email is checked and throws error if doesn’t match the built in REGEX pattern
GBR_EXCEPTION_3063	Expression error	When any form of REGEX failed to excute due to incorrect inputs
GBR_EXCEPTION_3065	Retry exhausted, Redelivery Exhausted	Retry component reaches the threshold number with respect to HTTP requests made
GBR_EXCEPTION_3066	Connectivity issue or service is not available	When cannot reach the resource URL or underneath service doesn’t respond
GBR_EXCEPTION_3067	HTTP time out	When the HTTP request gets timed out

Passenger Assist

The following categories relate to Passenger Assist specific errors

Profile

Code	Message	Comment
GBR_PA_6200	Passenger Profile not found	The requested Passenger Assist profile is not stored within the system and cannot be validated

Booking

Code	Message	Comment
GBR_PA_6300	Booking not found	The requested Booking cannot be found in the system
GBR_PA_6301	Unable to process Booking. [Reason for Error]	The system cannot create the booking and a reason is supplied as part of this message from the source system
GBR_PA_6302	Booking cannot be cancelled	The system is unable to cancel the booking, see cancel booking prerequisites

Passenger Assist API

Check PA Profile

List Journey Assistances

Create PA Booking

Cancel PA Booking