Response Codes

For response JSON root element or response object that have a ‘status’ field as an attribute will be identified the general response type from Agoda’s API servers.

Success Status

Status Code	Status Meaning	Status Definition
200	Accepted	Request has been accepted and processed
202	Okay	Request is queued up for processing
204	No content	The request does not return any valid data
206	Partial content	The request has been successfully processed and there is content returned but this is not the complete set / Asynchronous search
302	3DS Redirect	This is a success response and sent in case of 3DS redirect

Search and Book Error Status

Status Code	Status Meaning	Status Definition
400	Bad Request	The request could not be understood by the system, malformed syntax.
401	Unauthorized	If ApiKey not found or IP address restrictions violated
403	Forbidden	You have violated our terms of use and exceed the quota of requests
404	FileNotFound	Service or file not found.
429	Too Many requests	The user has sent too many requests in a given amount of time.
500	Internal Server Error	We have encountered and unrecoverable problem in the processing of the API call
503	Service Unavailable	Due to maintenance is that either planned or ad-hoc, service is temporary unavailable
506	PartialConfirm	Cannot process the entire request, need to contact customer service.

Precheck Error Status

Status Code	Status Meaning	Status Definition
429	Too Many requests	The user has sent too many requests in a given amount of time.
501	Price Change	Room has allotment still available but the rate has changed"
502	Price Change with Recommendation	The room rate has changed but the other room has the rate match
503	Room not Available	Room no longer has allotment
504	Room not Available with Recommendation	Room no longer has allotment but the other room is still available

Retryable HTTP status codes for PostBooking APIs

HTTP status codes	Status Meaning
500	Internal Server Error
429	Too Many Requests / Rate Limit

Response Body

Success responses

In case you received a success response status, the response body will, if applicable for the request, contain the response object as defined in the conversation specification.

Error responses

In case you receive an error response, the response body will contain an "errorMessage" that identify as best as we can identify the exact problems or validation problems that we have encountered while processing your request.

{
    "status": "400",
    "errorMessage": {
        "id": "909",
        "subId": "7110",
        "message": "Sorry, there are no available rooms for your chosen dates"
    }
}

ErrorMessage id	ErrorMessage subid	ErrorMessage	Category
101		Site ID 0 is invalid	All
102		API key 0 is invalid	All
108		Site ID or API key is invalid or missing in the header	All
901		Authentication failed	All
906		Invalid request format:0	All
907		Invalid data:0	All
909	1	Internal error	All
909	2	Sorry, there are no available rooms for your chosen dates.	Booking
909	100	Technical Error	Booking, Cancellation, Confirm Cancel
909	101	Invalid User ID	Booking, Cancellation
909	104	Booking has been cancelled	Cancellation
909	109	Checkin date passed	Cancellation
909	114	Cancellation request is pending	Cancellation
909	115	Booking is currently being processed by the system	Cancellation
909	116	Invalid cancellation reason ID	Cancellation
909	120	Refund validation failure	Cancellation
909	121	Not be able to process temporarily	Cancellation
909	125	Validation failed for input request	Cancellation
909	126	Booking ID mismatched with Site ID	Cancellation
909	128	Booking can not be cancelled	Cancellation
909	129	Booking not found	Confirm Cancel
909	130	Booking Not Eligible	Confirm Cancel
909	131	Whitelabel data not compatible	Confirm Cancel
909	212	Pre authorization fail	Booking
909	219	Invalid credit card information	Booking
909	222	Booking is non-refundable and non-amendable	Cancellation
909	301	Invalid booking request	Booking
909	302	Duplicated booking	Booking
909	305	Booking info is not complete	Booking
909	401	CreditCard Type is required	Booking
909	402	Invalid credit card number	Booking
909	403	Invalid credit card expire date	Booking
909	404	Invalid credit card security code	Booking
909	405	Invalid credit card holder name	Booking
909	406	Invalid credit card country of issue	Booking
909	407	Invalid credit card of issue bank	Booking
909	409	Invalid Card Class	Booking
909	410	Credit card expire date mismatch	Booking
909	411	Credit card expire date wrong format	Booking
909	412	Credit card security code wrong format	Booking
909	413	Credit card number wrong digit	Booking
909	414	Credit card are not Amex	Booking
909	415	Credit card are not MasterCard	Booking
909	416	Credit card are not Visa	Booking
909	417	Credit card are not JCB	Booking
909	418	Credit card number wrong format	Booking
909	419	Pre authorization fail	Booking
909	420	Invalid gateway id	Booking
909	421	Invalid card status	Booking
909	422	Payment Currency is empty	Booking
909	423	Payment Amount mismatch	Booking
909	424	Exchange rate or Uplift exchange rate or Site exchange rate is zero	Booking
909	425	Settlement Failed	Booking
909	426	Invalid card holder phone number	Booking
909	427	Invalid Transaction ID	Booking
909	428	Invalid Customer Identification Card	Booking
909	429	Invalid One Time Password	Booking
909	430	CC Id is less than zero	Booking
909	431	Invalid customer information	Booking
909	432	Invalid customer firstname	Booking
909	433	Invalid customer lastname	Booking
909	434	Invalid customer email	Booking
909	435	Invalid customer country id	Booking
909	436	Invalid credit card type	Booking
909	441	Invalid guest information	Booking
909	442	Invalid guest primary	Booking
909	444	Invalid guest firstname	Booking
909	445	Invalid guest lastname	Booking
909	446	Guest are duplicated	Booking
909	447	Guest nationality restriction	Booking
909	448	Guest nationality restriction by hotel	Booking
909	449	Invalid guest nationality id	Booking
909	451	Invalid hotel information	Booking
909	452	Invalid check in information	Booking
909	453	Invalid check out information	Booking
909	454	Invalid Hotel ID	Booking
909	455	Invalid DMC ID	Booking
909	456	Invalid Booking Period	Booking
909	457	No of adults or No of childrens mismatch	Booking
909	461	Invalid room information	Booking
909	462	Invalid room no in charge	Booking
909	463	Invalid room type name	Booking
909	464	Room no mismatch	Booking
909	471	Invalid charge information	Booking
909	473	Invalid booking amount	Booking
909	521	Invalid Expiry Year	Booking
909	522	Invalid Expiry Month	Booking
909	523	Required CCId or CardNumber	Booking
909	524	Invalid Card Number Format	Booking
909	525	Invalid Card Expiry	Booking
909	601	Invalid cancellation policy code	Booking
909	602	Get fully charge date error	Booking
909	603	Credit card expire before fully charge date	Booking
909	604	Book now pay later not support BE3	Booking
909	605	Book now pay later not support agency booking	Booking
909	606	Book now pay later not support B2B	Booking
909	607	Book now pay later not support multiple bookings	Booking
909	608	Book now pay later not support redirect card	Booking
909	609	Book now pay later not support debit card	Booking
909	610	Book now pay later not support this payment method	Booking
909	611	Technical error while validate BNPL	Booking
909	612	Book now pay later not support Carte Bleue	Booking
909	613	Booking date or amendment date is invalid	Booking
909	614	Booking date or amendment date passed book now pay later period	Booking
909	615	Invalid fully charge date	Booking
909	616	This booking is not support pay later	Booking
909	617	Booking is non-refundable.	Booking
909	618	Invalid fully auth date	Booking
909	619	This function is not available.	Booking
909	703	Invalid guest first name format.	Booking
909	706	Customer firstname must be English only.	Booking
909	707	Customer lastname must be English only.	Booking
909	708	Require customer email.	Booking
909	709	Invalid customer email format.	Booking
909	710	Require customer phoneno.	Booking
909	711	Reward Saving Amount is not greater than payment amount.	Booking
909	712	Exchange rate must greater than 0.	Booking
909	713	The currency is not offered.	Booking
909	714	Incorrect Rounding	Booking
909	715	Invalid Phone No format.	Booking
909	720	The creditcard type is not enable for this language.	Booking
909	721	Country is restricted.	Booking
909	724	Hotel is in restricted country.	Booking
909	725	Nationality is restricted.	Booking
909	726	First name cannot be blank or white space	Booking
909	727	Invalid guest last name format.	Booking
909	728	Last name cannot be blank or white space	Booking
909	729	YCS Rate Plan is required.	Booking
909	7110	Sorry, there are no available rooms for your chosen dates.	Booking
909	419	Preauthorize Fail	Booking
909	11212	Sorry, booking was not confirmed, process timeout	Booking
911		No search result	Search
912		Search ID 0 has expired	Booking
913		Service Unavailable: API Key Suspended	Search and Booking
914		Invalid data: 0	Booking, Cancellation
917		Invalid currency request	Search
919		Wrong rate configuration	Search
920		BNPL Invalid: Booking room with BNPL support but no have BNPL in search	Booking
926		Too many requests	Search and Content
940		Room price has changed	Booking

Language

The list of valid languages Agoda supports which use to communicate with us are:
Note: If available, otherwise defaulting to en-us

Language ID	Language Code	Language Definition
1	en-us	English
2	fr-fr	French
3	de-de	German
4	it-it	Italian
5	es-es	Spanish
6	ja-jp	Japanese
7	zh-hk	T.Chinese / Hongkong
8	zh-cn	S.Chinese / Mainland
9	ko-kr	Korean
10	el-gr	Greek
11	ru-ru	Russian
12	pt-pt	Portugese
13	nl-nl	Dutch, Belgium
14	en-ca	English / Canada
15	en-in	English / India
16	en-gb	English / United Kingdom
17	en-za	English / South-Africa
18	en-au	English / Australia
19	en-sg	English / Singapore
20	zh-tw	T. Chinese / Taiwan
21	en-nz	English / New Zealand
22	th-th	Thai
23	ms-my	Malay
24	vi-vn	Vietnamese
25	sv-se	Swedish
26	id-id	Indonesian
27	pl-pl	Polish
28	nb-no	Norwegian
29	da-dk	Danish
30	fi-fi	Finnish
31	cs-cz	Czech
32	tr-tr	Turkish
33	ca-es	Catalan
34	hu-hu	Hungarian
36	bg-bg	Bulgarian
37	ro-ro	Romanian
38	sl-si	Slovenian
39	he-il	Hebrew
40	ar-ae	Arabic
41	nl-be	Dutch / Belgium
42	en-ie	English / Ireland
43	pt-br	Portuguese / Brazil
44	es-ar	panish / Argentina
45	es-mx	Spanish / Mexico
46	lt-lt	Lithuanian
47	lv-lv	Latvian
48	hr-hr	Croatian
49	et-ee	Estonian
50	uk-ua	Ukrainian
51	tl-ph	Filipino

Currency

The list of valid currencies Agoda supports which you use to communicate with us are:

Currency Code	Currency Definition
EUR	Euro
GBP	British Pound
HKD	Hong Kong Dollar
MYR	Malaysian Ringgit
SGD	Singapore Dollar
THB	Thai Baht
USD	US Dollar
NZD	New Zealand Dollar
AUD	Australian Dollar
JPY	Japanese Yen
ZAR	South African Rand
CAD	Canadian Dollar
AED	Arab Emirates Dirham
CNY	Chinese Yuan
PHP	Philippine Peso
CHF	Swiss Franc
DKK	Danish Krone
SEK	Swedish Krona
CZK	Czech Koruna
PLN	Polish Zloty
IDR	Indonesian Rupiah
KRW	Korean Won
INR	Indian Rupee
TWD	Taiwan Dollar
NOK	Norwegian Krone
OMR	Omani Rial
FJD	Fiji Dollar
BHD	Bahrain Dinar
XPF	CFP Franc
VND	Vietnamese Dong
HUF	Hungarian Forint
UAH	Ukrainian Grivna
JOD	Jordanian Dinar
KWD	Kuwaiti Dinar
MXN	Mexican Peso
NGN	Nigerian Naira
ILS	New Israeli Sheqel
PKR	Pakistan Rupee
QAR	Qatari Rial
RUB	Russian Ruble
SAR	Saudi Riyal
KZT	Kazakh Tenge
TRY	Turkish Lira
BGN	Bulgarian Lev
RON	Romanian Leu
KHR	Cambodian Riel
LAK	Laotian Kip
LKR	Sri Lankan Rupee
MVR	Maldivian Rufiyaa
EGP	Egyptian Pounds
BRL	Brazilian Real
AFN	Afghan Afghani
COP	Colombian Peso
BDT	Bangladeshi Taka

Accepted currencies per payment card

The following table lists the valid currencies per payment card.

Card type	Accepted Currency
Visa	AED,AUD,BAM,BDT,BGN,BHD,BOB,BYR,CAD,CHF,CLP,CNY,COP,CYP,CZK,DKK,DZD,EEK,EGP,EUR,FJD,GBP,HKD,HUF,IDR,ILS,INR,IRR,ISK,JOD,JPY,KES,KRW,KWD,KZT,LAK,LBP,LKR,LTL,LVL,LYD,MAD,MNT,MOP,MRO,MTL,MXN,MYR,NAD,NGN,NOK,NPR,NZD,OMR,PEN,PGK,PHP,PKR,PLN,PYG,QAR,RON,SAR,SCR,SEK,SGD,THB,TND,TRY,TWD,TZS,UAH,USD,UYU,VND,VUV,XPF,ZAR
MasterCard	AED,AUD,BAM,BDT,BGN,BHD,BOB,BYR,CAD,CHF,CLP,CNY,COP,CYP,CZK,DKK,DZD,EEK,EGP,EUR,FJD,GBP,HKD,HUF,IDR,ILS,INR,IRR,ISK,JOD,JPY,KES,KRW,KWD,KZT,LAK,LBP,LKR,LTL,LVL,LYD,MAD,MNT,MOP,MRO,MTL,MXN,MYR,NAD,NGN,NOK,NPR,NZD,OMR,PEN,PGK,PHP,PKR,PLN,PYG,QAR,RON,SAR,SCR,SEK,SGD,THB,TND,TRY,TWD,TZS,UAH,USD,UYU,VND,VUV,XPF,ZAR
JCB	AUD,BHD,CNY,EUR,GBP,HKD,IDR,JPY,KRW,MYR,PHP,SGD,THB,TWD,USD,VND,INR
American Express	AED,AUD,BAM,BGN,BHD,CHF,CNY,CZK,DKK,EGP,EUR,GBP,HKD,HRK,HUF,ILS,ISK,JPY,JOD,KES,KRW,KWD,KZT,LBP,MUR,MYR,NOK,NZD,OMR,PKR,PLN,QAR,RON,SAR,SEK,SGD,THB,TND,TRY,TWD,UAH,USD,IDR,CAD,PHP,VND,INR
Diners	SGD,JPY,USD,KRW,TWD,PHP
UnionPay - Debit Card	CNY,IDR,KHR,MYR,SGD,KRW,AUD,CAD,JPY,LAK,PKR,PHP,VND,USD
Discover	SGD,JPY,USD,KRW,TWD,PHP
Shinhan	KRW
UnionPay - Creditcard	CNY,KHR,HKD,MOP,IDR,MYR,SGD,KRW,THB,AUD,CAD,JPY,LAK,PKR,PHP,VND,USD
Samsung Card	KRW
NH Card	KRW
Lotte Card	KRW
KB Card	KRW
Hyundai Card	KRW
Hana Card	KRW
BC Card	KRW
Eftpos	AUD

Note: Discover card is not available for all partners. Please get confirmation from Agoda

Country

The list of valid countries Agoda supports which you use to communicate with us are:

Country Code	Country Name
AD	Andorra
AE	United Arab Emirates
AF	Afghanistan
AG	Antigua & Barbuda
AI	Anguilla
AL	Albania
AM	Armenia
AO	Angola
AR	Argentina
AS	American Samoa
AT	Austria
AU	Australia
AW	Aruba
AZ	Azerbaijan
BA	Bosnia Herzegovina
BB	Barbados
BD	Bangladesh
BE	Belgium
BF	Burkina Faso
BG	Bulgaria
BH	Bahrain
BI	Burundi
BJ	Benin
BL	Saint Barthelemy
BM	Bermuda
BN	Brunei Darussalam
BO	Bolivia
BQ	Bonaire Sint Eustatius and Saba
BR	Brazil
BS	Bahamas
BT	Bhutan
BV	Bouvet Island
BW	Botswana
BY	Belarus
BZ	Belize
CA	Canada
CC	Cocos (Keeling) Islands
CD	Congo, Democratic Republic of the
CF	Central African Republic
CG	Congo
CH	Switzerland
CI	Cote D’ivoire
CK	Cook Islands
CL	Chile
CM	Cameroon
CN	China
CO	Colombia
CR	Costa Rica
CV	Cape Verde
CW	Curacao
CX	Christmas Island
CY	Cyprus
CZ	Czech Republic
DE	Germany
DJ	Djibouti
DK	Denmark
DM	Dominica
DO	Dominican Republic
DZ	Algeria
EC	Ecuador
EE	Estonia
EG	Egypt
EH	Western Sahara
ER	Eritrea
ES	Spain
ET	Ethiopia
FI	Finland
FJ	Fiji
FK	Falkland Islands
FM	Micronesia
FO	Faroe Islands
FR	France
GA	Gabon
GB	United Kingdom
GD	Grenada
GE	Georgia
GF	French Guiana
GH	Ghana
GI	Gibraltar
GL	Greenland
GM	Gambia
GN	Guinea Republic
GP	Guadeloupe
GQ	Equatorial Guinea
GR	Greece
GS	South Georgia Islands
GT	Guatemala
GU	Guam
GW	Guinea-Bissau
GY	Guyana
HK	Hong Kong
HN	Honduras
HR	Croatia
HT	Haiti
HU	Hungary
ID	Indonesia
IE	Ireland
IL	Israel
IN	India
IO	British Indian Ocean Territory
IQ	Iraq
IS	Iceland
IT	Italy
JM	Jamaica
JO	Jordan
JP	Japan
KE	Kenya
KG	Kyrgyzstan
KH	Cambodia
KI	Kiribati
KM	Comoros
KN	Saint Kitts And Nevis
KR	South Korea
KW	Kuwait
KY	Cayman Islands
KZ	Kazakhstan
LA	Laos
LB	Lebanon
LC	Saint Lucia
LI	Liechtenstein
LK	Sri Lanka
LR	Liberia
LS	Lesotho
LT	Lithuania
LU	Luxembourg
LV	Latvia
LY	Libya
MA	Morocco
MC	Monaco
MD	Moldova
ME	Montenegro
MF	Saint Martin (France)
MG	Madagascar
MH	Marshall Islands
MK	Macedonia
ML	Mali
MM	Myanmar
MN	Mongolia
MO	Macau
MP	Northern Mariana Islands
MQ	Martinique
MR	Mauritania
MS	Montserrat
MT	Malta
MU	Mauritius
MV	Maldives
MW	Malawi
MX	Mexico
MY	Malaysia
MZ	Mozambique
NA	Namibia
NC	New Caledonia
NE	Niger
NF	Norfolk Island
NG	Nigeria
NI	Nicaragua
NL	Netherlands
NO	Norway
NP	Nepal
NR	Nauru
NU	Niue
NZ	New Zealand
OM	Oman
PA	Panama
PE	Peru
PF	French Polynesia
PG	Papua New Guinea
PH	Philippines
PK	Pakistan
PL	Poland
PM	Saint Pierre and Miquelon
PN	Pitcairn Islands
PR	Puerto Rico
PS	Palestinian Territory
PT	Portugal
PW	Palau
PY	Paraguay
QA	Qatar
RE	Reunion Island
RO	Romania
RS	Serbia
RU	Russia
RW	Rwanda
SA	Saudi Arabia
SB	Solomon Islands
SC	Seychelles
SE	Sweden
SG	Singapore
SH	Saint Helena
SI	Slovenia
SK	Slovakia
SL	Sierra Leone
SM	San Marino
SN	Senegal
SO	Somalia
SR	Suriname
SS	South Sudan
ST	Sao Tome and Principe
SV	El Salvador
SX	Sint Maarten ( Netherlands)
SZ	Swaziland
TC	Turks & Caicos Islands
TD	Chad
TF	French Southern and Antarctic Lands
TG	Togo
TH	Thailand
TJ	Tajikistan
TK	Tokelau
TL	Timor-Leste
TM	Turkmenistan
TN	Tunisia
TO	Tonga
TR	Turkey
TT	Trinidad & Tobago
TV	Tuvalu
TW	Taiwan
TZ	Tanzania
UA	Ukraine
UG	Uganda
US	United States
UY	Uruguay
UZ	Uzbekistan
VA	Vatican
VC	St. Vincent & Grenadines
VE	Venezuela
VG	Virgin Islands (British)
VI	Virgin Islands (U.S.)
VN	Vietnam
VU	Vanuatu
WF	Wallis and Futuna
WS	Samoa
XK	Kosovo
YE	Yemen
YT	Mayotte
ZA	South Africa
ZM	Zambia
ZW	Zimbabwe

Fee Waiver Status

The list of valid Fee Waiver status Agoda supports which you use to communicate with us are:

Fee Waiver Status	Description
Pending	Fee waiver is waiting for a response from the hotel
Accept	Fee waiver accepted by the hotel
Reject	Fee waiver rejected by the hotel
Cancelled	Booking has been cancelled
Timeout	We didn't get any response for Fee waiver request from hotel and time is over.

Fee Waiver Reason

The list of valid Fee Waiver reason Agoda supports which you use to communicate with us are:

Fee Waiver Reason number	Description
1	FoundDifferentAccommodationOption
2	ChangeNumberOfTravelers
3	TripCalledOff
4	Covid19
5	ChangeDateOrDestination
6	BookOnSameDate
7	Other