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": { "...": "..." }}
| Field | What it is |
|---|---|
status | The HTTP status code. |
error | The HTTP status text. |
code | The API error code. Match on this in your integration. |
title | What went wrong, in plain words. |
detail | Extra detail for debugging, when present. |
correlationId | A 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
| Status | When you get it |
|---|---|
400 | The request is malformed. |
401 | Missing or invalid credentials. |
403 | Your credentials are valid but not allowed to do this. |
404 | The resource does not exist. |
409 | Duplicate or conflicting request. |
422 | The request is well formed but fails validation or a business rule. Most booking errors land here. |
429 | Too many requests. Back off and retry. |
500 | Something broke inside GO7. |
503 | The 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
| Situation | What comes back |
|---|---|
| A search finds no train | 200 with an empty pricedItinerary list. This is not an error. |
| A round trip where only one leg has a train | 400. 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 price | 422 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 booking | Code 499, “The selected train, segment, or fare is no longer available”. Search again. |
| The price moved between search and booking | Code 883, “Price change detected”. Search again. |
| The wallet cannot cover the tickets | Code 877, “Insufficient available funds found in your credit line”. Top up and retry. |
A document type other than 2 or 5 | 422 with code 878, “Missing/incorrect document type”. |
| A seat map or seat change outside the allowed window | CHANGES_ARE_NOT_PERMITTED, or code 150, “Changes are not permitted”. See Seat maps. |
| A name change after ticketing | Code 417, “Name change not allowed”. |
| The railway is unavailable | 503 with code 450, “Unable to process”. Retry with backoff. |
Handling errors well
- Match on
code, not ontitle. The wording can change; the code does not. - Log the
correlationIdwith every failed call. It is the fastest way for support to find the request. - Retry
429,500, and503with exponential backoff. Do not retry a4xxwithout 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
GO7 codes (internal)
| Code | Means |
|---|---|
6 | Service closed for sales |
7 | Route code invalid |
8 | No reservations on route requested |
9 | Requested service is fully booked |
11 | Service connections not possible |
15 | Invalid date |
16 | Service has been cancelled |
17 | Time request not with fare/tariff |
19 | Name is missing or incomplete |
20 | Number of passengers invalid |
21 | Passenger type quota exceeded |
22 | Passengers exceed commercial rules |
23 | Passenger type not supported |
24 | Passenger class capacity exceeded |
25 | Passenger types not consistent |
26 | At least one adult must be included |
27 | Passenger details are mandatory |
42 | Too many classes |
48 | Tariff type invalid |
49 | Tariff invalid for passenger mix |
53 | No price exists for the tariff |
58 | Price(s) cannot be validated |
59 | Offer price cannot be calculated |
60 | Ticket numbers missing or invalid |
61 | Invalid currency code |
63 | Cannot ticket until booking priced |
64 | Tickets do not match reservation |
65 | Cannot ticket, already issued |
71 | Cannot ticket at this agency |
72 | Cannot ticket, cancelled booking |
73 | Cannot ticket, expired booking |
74 | Cannot ticket, itinerary commenced |
76 | Ticket issue request not possible |
83 | Leg, journey, or itinerary reference invalid |
86 | Cannot cancel, itinerary complete |
87 | Booking reference invalid |
95 | Booking already cancelled |
96 | Duplicated itinerary |
97 | Booking reference not found |
99 | Booking not owned by requester |
101 | Cannot book, departure too close |
102 | Booking reference not connected |
103 | Cannot access, itinerary complete |
107 | Cannot book, too far in advance |
111 | Booking invalid |
113 | Mandatory booking details missing |
117 | Cannot access booking details |
118 | Booking status invalid |
122 | End date has passed |
123 | Too many children |
124 | Too many babies |
127 | Reservation already exists |
146 | Service requested incorrect |
150 | Changes are not permitted |
158 | Departure or to date required |
161 | Search criteria invalid |
163 | Payment type invalid |
167 | Payment rejected |
171 | Booking not made by this agent |
172 | Requested action not possible |
173 | Agency code required |
174 | Bookings made by different agents |
175 | Password invalid |
181 | Invalid country code |
182 | Password required |
183 | Agency suspended, access denied |
184 | Language code invalid |
187 | System currently unavailable |
189 | Payment not authorised |
190 | Wrong network, access denied |
191 | System busy, please try later |
193 | Cancellation process failed |
194 | No matching bookings found |
195 | Service restriction, security |
239 | Flight number must be accompanied by an airline |
240 | Credit card has expired |
241 | Expiration date is invalid |
242 | Credit card number is invalid or missing |
244 | Email address is invalid |
248 | Invalid airline code |
254 | Reservation date has passed |
264 | Reservation cannot be cancelled |
285 | Invalid first name |
286 | First name contains invalid characters |
287 | Invalid last name |
288 | Last name contains invalid characters |
293 | Invalid departure time |
294 | Invalid arrival time |
297 | Unable to process, insufficient data |
305 | Invalid booking source |
310 | Required data missing: last name |
311 | Required data missing: first name |
312 | Required data missing: airline flight number |
314 | Required data missing: country of residence |
318 | Required data missing: arrival time |
320 | Invalid value |
321 | Required field missing |
322 | No availability |
353 | Departure date is past dated |
356 | Invalid action or status code |
407 | Item too long |
417 | Name change not allowed |
420 | Need e-mail address |
448 | System error |
450 | Unable to process |
458 | Date outside inventory period |
497 | Authorization error |
499 | The selected train, segment, or fare is no longer available |
501 | Invalid date for flight requested |
508 | Invalid or missing reservation booking designator |
523 | Surname too long |
524 | Given name or title too long |
559 | Booking period restriction applies |
568 | Cancellation penalties apply |
569 | Group booking required |
570 | Cannot cancel, arrival too close, call property |
571 | Travel agency name required |
572 | Company name required |
631 | Company name code invalid or missing |
632 | Prepaid modify or cancel not allowed, call reservations |
633 | Unable to process your request, please remove the slash |
635 | Data not found |
713 | Currency of payment cannot be changed, must cancel or change |
743 | Invalid message length |
744 | Invalid field length |
745 | Invalid field ID |
768 | Inconsistent status |
770 | Required data missing: reservation holder |
854 | Booking allotment blocking failed |
860 | Passenger details error |
877 | Insufficient available funds found in your credit line |
878 | Missing or incorrect document type |
879 | Missing or incorrect document number |
883 | Price change detected |
884 | Currency change detected |
885 | Inconsistency between total returned and estimated total |
886 | Inconsistent settings for this client |
888 | Degraded performance, system throttling |
Railway codes (external)
The railway fills in the italic placeholders with the value in question.
| Code | Means |
|---|---|
1000 | Missing request token |
1001 | Missing parameter: name |
1002 | Unknown parameter: name |
1003 | Empty parameter: name |
1004 | Parameter name has invalid value value |
1010 | Agency id not found |
1011 | User id not found |
1020 | Route id not found |
1021 | The route id does not contain a segment id |
1022 | Missing segment id for route id |
1023 | Missing segment stations |
1024 | The segment is duplicated in the request |
1025 | The transport id has a departure time before the previous booking arrival |
1026 | Segments ids have already been cancelled |
1030 | Invalid category code |
1031 | Invalid profile code |
1032 | Missing or empty profiles |
1033 | Missing or invalid profile quantity value |
1050 | Reserved for future use |
1051 | Already used reference id: id |
1052 | Invalid reference id |
1053 | Not enough seats for category code |
1054 | Selected category code not found, or is not available |
1055 | Selected fare code not found, or is not available |
1056 | Selected profile code not found, or is not available |
1057 | Invalid context credentials for current request |
1058 | Unable to assign traveler seat |
1059 | Selected station not found: code |
1060 | Unknown purchase id: id |
1061 | Invalid state state for purchase id: id |
1062 | Invalid details for purchase id: id |
1063 | Unknown traveller id: id |
1064 | Invalid profile code for traveller id |
1065 | Traveller name not provided |
1066 | Traveller surname not provided |
1067 | Traveller birthday not provided |
1068 | Traveller identType not provided |
1069 | Traveller identNumber not provided |
1070 | Traveller identExpiration not provided |
1071 | Ticket price not provided |
1072 | Ticket spaceId not provided |
1073 | Ticket travellerId not provided |
1074 | Ticket transportId not provided |
1075 | Ticket fareId not provided |
1076 | Missing operationId |
1077 | Traveller gender type not provided |
1078 | Traveller id not provided |
1079 | Traveller nationality not provided |
1080 | Selected locale code not found, or is not available |
1081 | Invalid selected locale |
1082 | Traveller person type not provided |
1083 | The same ident number is used by more than one traveler: numbers |
1501 | Unable to recover downstream categories, response received: response |
1502 | Unable to recover downstream categories, empty response received |
1503 | Unable to recover downstream profiles, response received: response |
1504 | Unable to recover downstream profiles, empty response received |
1505 | Unable to recover downstream fares, response received: response |
1506 | Unable to recover downstream fares, empty response received |
1507 | Unable to recover downstream fare revenue, response received: response |
1508 | Unable to recover downstream fare revenue, empty response received |
1509 | Unable to recover downstream fare families, response received: response |
1510 | Unable to recover downstream fare families, empty response received |
1511 | Unable to recover downstream fees, response received: response |
1512 | Unable to recover downstream fees, empty response received |
1513 | Unable to recover downstream VAT, response received: response |
1514 | Unable to recover downstream VAT, empty response received |
1515 | Unable to recover downstream occupancy, response received: response |
1516 | Unable to recover downstream occupancy, empty response received |
1517 | Unable to recover downstream occupancy rules, response received: response |
1518 | Unable to recover downstream occupancy rules, empty response received |
1519 | Unable to recover downstream routes, response received: response |
1520 | Unable to recover downstream routes, empty response received |
1521 | Unable to recover downstream routes, response received: response |
1522 | Unable to recover downstream routes, empty response received |
1523 | Unable to recover downstream trains, response received: response |
1524 | Unable to recover downstream trains, empty response received |
1600 | Availability service fault: detail |
1601 | Unable to generate pass, missing traveller space |
1602 | Unable to confirm bookings |
1603 | Unable to cancel bookings |
1604 | Unable to decline bookings |
1900 | Policy name not satisfied |
3001 | Booking ids not found: ids |
3002 | Missing search parameters |
3003 | Service (train, stations, and times) not found |
3004 | An infant cannot travel without an accompanying adult |
3005 | Each infant must be assigned to a single adult within the reservation |
3501 | Missing parameter name |
3502 | The seat seat is not reserved |
3503 | The seat seat has an invalid state |
3504 | The seat (id, departure time, and arrival time) is no longer reserved |
3505 | The reservation cannot be cancelled: reason |
3506 | Occupancy for train (id and times) not found |
3507 | There is no occupancy data for the category category |
3508 | There are no available seats to complete the reservation |
3509 | Train (id, stations, and times) was cancelled |
3510 | Train (id, stations, and times) was locked |
3511 | The reservation cannot be completed. The quota for the service has been changed |
5001 | Unknown purchase id: id |
5002 | Invalid state state for booking id: id |
The lists above mirror the GO7 error-response page. When GO7 adds a code, it appears there first.

