Skip to navigation

Errors

What a failed request returns and how to read it
View as Markdown

When a request fails, the API returns a Problem JSON object with an HTTP status and a code you can act on. Read code and title to see what went wrong, and keep correlationId if you need to raise it with support.

The shape of an error

{
"status": 422,
"error": "Unprocessable Entity",
"code": "878",
"title": "Missing/incorrect document type",
"detail": "No identType found for document type code CC",
"correlationId": "88f48120-952c-4ebe-b889-809c129932ea",
"service": "ota-service",
"instance": "/v2015b/OTA",
"tenant": "sar",
"timestamp": "2026-05-01T09:48:11.178Z",
"cause": { "...": "..." }
}
FieldWhat it is
statusThe HTTP status code.
errorThe HTTP status text.
codeThe API error code. Match on this in your integration.
titleWhat went wrong, in plain words.
detailExtra detail for debugging, when present.
correlationIdA trace ID. Give this to support to look up the request.

The remaining fields are for GO7’s own use. service, instance, tenant, and timestamp say where and when the error was raised. cause nests the raw error from each hop in the chain, and you can ignore it: the top-level fields already carry the root cause.

HTTP status codes

StatusWhen you get it
400The request is malformed.
401Missing or invalid credentials.
403Your credentials are valid but not allowed to do this.
404The resource does not exist.
409Duplicate or conflicting request.
422The request is well formed but fails validation or a business rule. Most booking errors land here.
429Too many requests. Back off and retry.
500Something broke inside GO7.
503The railway or a GO7 service is unavailable. Retry later.

Where errors come from

Two kinds of error reach you, both in the same shape. An internal error arises inside GO7. An external error arises in the railway’s system or another third party. GO7 reformats an external error into the shape above but keeps its original status, code, title, and detail, so the code you see is the railway’s own. The code lists at the end of this page are split along the same line.

Common situations

SituationWhat comes back
A search finds no train200 with an empty pricedItinerary list. This is not an error.
A round trip where only one leg has a train400. Each leg is searched on its own and combined, so both need a train.
The flight or fare you booked against no longer matches a price422 with code 53, “No price exists for the tariff”. Run a fresh search and book again.
The train, segment, or fare sold out between search and bookingCode 499, “The selected train, segment, or fare is no longer available”. Search again.
The price moved between search and bookingCode 883, “Price change detected”. Search again.
The wallet cannot cover the ticketsCode 877, “Insufficient available funds found in your credit line”. Top up and retry.
A document type other than 2 or 5422 with code 878, “Missing/incorrect document type”.
A seat map or seat change outside the allowed windowCHANGES_ARE_NOT_PERMITTED, or code 150, “Changes are not permitted”. See Seat maps.
A name change after ticketingCode 417, “Name change not allowed”.
The railway is unavailable503 with code 450, “Unable to process”. Retry with backoff.

Handling errors well

  • Match on code, not on title. The wording can change; the code does not.
  • Log the correlationId with every failed call. It is the fastest way for support to find the request.
  • Retry 429, 500, and 503 with exponential backoff. Do not retry a 4xx without changing the request.
  • Treat an empty search result as a normal response and show “no trains”, not an error.
  • A dynamic-fare error usually means the price moved. Run a fresh search and book against the new result.

All error codes

CodeMeans
6Service closed for sales
7Route code invalid
8No reservations on route requested
9Requested service is fully booked
11Service connections not possible
15Invalid date
16Service has been cancelled
17Time request not with fare/tariff
19Name is missing or incomplete
20Number of passengers invalid
21Passenger type quota exceeded
22Passengers exceed commercial rules
23Passenger type not supported
24Passenger class capacity exceeded
25Passenger types not consistent
26At least one adult must be included
27Passenger details are mandatory
42Too many classes
48Tariff type invalid
49Tariff invalid for passenger mix
53No price exists for the tariff
58Price(s) cannot be validated
59Offer price cannot be calculated
60Ticket numbers missing or invalid
61Invalid currency code
63Cannot ticket until booking priced
64Tickets do not match reservation
65Cannot ticket, already issued
71Cannot ticket at this agency
72Cannot ticket, cancelled booking
73Cannot ticket, expired booking
74Cannot ticket, itinerary commenced
76Ticket issue request not possible
83Leg, journey, or itinerary reference invalid
86Cannot cancel, itinerary complete
87Booking reference invalid
95Booking already cancelled
96Duplicated itinerary
97Booking reference not found
99Booking not owned by requester
101Cannot book, departure too close
102Booking reference not connected
103Cannot access, itinerary complete
107Cannot book, too far in advance
111Booking invalid
113Mandatory booking details missing
117Cannot access booking details
118Booking status invalid
122End date has passed
123Too many children
124Too many babies
127Reservation already exists
146Service requested incorrect
150Changes are not permitted
158Departure or to date required
161Search criteria invalid
163Payment type invalid
167Payment rejected
171Booking not made by this agent
172Requested action not possible
173Agency code required
174Bookings made by different agents
175Password invalid
181Invalid country code
182Password required
183Agency suspended, access denied
184Language code invalid
187System currently unavailable
189Payment not authorised
190Wrong network, access denied
191System busy, please try later
193Cancellation process failed
194No matching bookings found
195Service restriction, security
239Flight number must be accompanied by an airline
240Credit card has expired
241Expiration date is invalid
242Credit card number is invalid or missing
244Email address is invalid
248Invalid airline code
254Reservation date has passed
264Reservation cannot be cancelled
285Invalid first name
286First name contains invalid characters
287Invalid last name
288Last name contains invalid characters
293Invalid departure time
294Invalid arrival time
297Unable to process, insufficient data
305Invalid booking source
310Required data missing: last name
311Required data missing: first name
312Required data missing: airline flight number
314Required data missing: country of residence
318Required data missing: arrival time
320Invalid value
321Required field missing
322No availability
353Departure date is past dated
356Invalid action or status code
407Item too long
417Name change not allowed
420Need e-mail address
448System error
450Unable to process
458Date outside inventory period
497Authorization error
499The selected train, segment, or fare is no longer available
501Invalid date for flight requested
508Invalid or missing reservation booking designator
523Surname too long
524Given name or title too long
559Booking period restriction applies
568Cancellation penalties apply
569Group booking required
570Cannot cancel, arrival too close, call property
571Travel agency name required
572Company name required
631Company name code invalid or missing
632Prepaid modify or cancel not allowed, call reservations
633Unable to process your request, please remove the slash
635Data not found
713Currency of payment cannot be changed, must cancel or change
743Invalid message length
744Invalid field length
745Invalid field ID
768Inconsistent status
770Required data missing: reservation holder
854Booking allotment blocking failed
860Passenger details error
877Insufficient available funds found in your credit line
878Missing or incorrect document type
879Missing or incorrect document number
883Price change detected
884Currency change detected
885Inconsistency between total returned and estimated total
886Inconsistent settings for this client
888Degraded performance, system throttling

The railway fills in the italic placeholders with the value in question.

CodeMeans
1000Missing request token
1001Missing parameter: name
1002Unknown parameter: name
1003Empty parameter: name
1004Parameter name has invalid value value
1010Agency id not found
1011User id not found
1020Route id not found
1021The route id does not contain a segment id
1022Missing segment id for route id
1023Missing segment stations
1024The segment is duplicated in the request
1025The transport id has a departure time before the previous booking arrival
1026Segments ids have already been cancelled
1030Invalid category code
1031Invalid profile code
1032Missing or empty profiles
1033Missing or invalid profile quantity value
1050Reserved for future use
1051Already used reference id: id
1052Invalid reference id
1053Not enough seats for category code
1054Selected category code not found, or is not available
1055Selected fare code not found, or is not available
1056Selected profile code not found, or is not available
1057Invalid context credentials for current request
1058Unable to assign traveler seat
1059Selected station not found: code
1060Unknown purchase id: id
1061Invalid state state for purchase id: id
1062Invalid details for purchase id: id
1063Unknown traveller id: id
1064Invalid profile code for traveller id
1065Traveller name not provided
1066Traveller surname not provided
1067Traveller birthday not provided
1068Traveller identType not provided
1069Traveller identNumber not provided
1070Traveller identExpiration not provided
1071Ticket price not provided
1072Ticket spaceId not provided
1073Ticket travellerId not provided
1074Ticket transportId not provided
1075Ticket fareId not provided
1076Missing operationId
1077Traveller gender type not provided
1078Traveller id not provided
1079Traveller nationality not provided
1080Selected locale code not found, or is not available
1081Invalid selected locale
1082Traveller person type not provided
1083The same ident number is used by more than one traveler: numbers
1501Unable to recover downstream categories, response received: response
1502Unable to recover downstream categories, empty response received
1503Unable to recover downstream profiles, response received: response
1504Unable to recover downstream profiles, empty response received
1505Unable to recover downstream fares, response received: response
1506Unable to recover downstream fares, empty response received
1507Unable to recover downstream fare revenue, response received: response
1508Unable to recover downstream fare revenue, empty response received
1509Unable to recover downstream fare families, response received: response
1510Unable to recover downstream fare families, empty response received
1511Unable to recover downstream fees, response received: response
1512Unable to recover downstream fees, empty response received
1513Unable to recover downstream VAT, response received: response
1514Unable to recover downstream VAT, empty response received
1515Unable to recover downstream occupancy, response received: response
1516Unable to recover downstream occupancy, empty response received
1517Unable to recover downstream occupancy rules, response received: response
1518Unable to recover downstream occupancy rules, empty response received
1519Unable to recover downstream routes, response received: response
1520Unable to recover downstream routes, empty response received
1521Unable to recover downstream routes, response received: response
1522Unable to recover downstream routes, empty response received
1523Unable to recover downstream trains, response received: response
1524Unable to recover downstream trains, empty response received
1600Availability service fault: detail
1601Unable to generate pass, missing traveller space
1602Unable to confirm bookings
1603Unable to cancel bookings
1604Unable to decline bookings
1900Policy name not satisfied
3001Booking ids not found: ids
3002Missing search parameters
3003Service (train, stations, and times) not found
3004An infant cannot travel without an accompanying adult
3005Each infant must be assigned to a single adult within the reservation
3501Missing parameter name
3502The seat seat is not reserved
3503The seat seat has an invalid state
3504The seat (id, departure time, and arrival time) is no longer reserved
3505The reservation cannot be cancelled: reason
3506Occupancy for train (id and times) not found
3507There is no occupancy data for the category category
3508There are no available seats to complete the reservation
3509Train (id, stations, and times) was cancelled
3510Train (id, stations, and times) was locked
3511The reservation cannot be completed. The quota for the service has been changed
5001Unknown purchase id: id
5002Invalid state state for booking id: id

The lists above mirror the GO7 error-response page. When GO7 adds a code, it appears there first.