YM REST Services

<back to all web services

Countries

Requires Authentication
Requires any of the roles:admin, oauthadmin
The following routes are available for this service:
GET/Ams/{ClientID}/CountriesReturn a list of Countries or a specific country object.Use any of the query arguments to narrow the results.
Countries Parameters:
NameParameterData TypeRequiredDescription
countryIdquerystringNo
countryCodequerystringNo
BaseDto Parameters:
NameParameterData TypeRequiredDescription
UsingRedisformboolNo
AppInitTimeformDateTimeNo
ServerIDformstringNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
CountriesResponse Parameters:
NameParameterData TypeRequiredDescription
defaultCountryformCountryNo
countryListformList<Country>No
Country Parameters:
NameParameterData TypeRequiredDescription
countryIdformstringNo
countryCodeformstringNo
countryNameformstringNo
numberOfLocationsformintNo
taxShippingformboolNo
taxDuesformboolNo
locationLabelformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /Ams/{ClientID}/Countries HTTP/1.1 
Host: ws.yourmembership.com 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"defaultCountry":{"countryId":"String","countryCode":"String","countryName":"String","numberOfLocations":0,"taxShipping":false,"taxDues":false,"locationLabel":"String"},"countryList":[{"countryId":"String","countryCode":"String","countryName":"String","numberOfLocations":0,"taxShipping":false,"taxDues":false,"locationLabel":"String"}],"countryId":"String","countryCode":"String","UsingRedis":true,"AppInitTime":"2024-05-03T02:25:06.8728823-04:00","ServerID":"WS-6-183-431","ClientID":0,"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}},"BypassCache":false,"DateCached":"2024-05-03T04:57:46.5414098-04:00","Device":"Desktop"}