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 .jsv suffix or ?format=jsv

HTTP + JSV

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: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
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-03T00:23:17.2698967-04:00,
	ServerID: WS-6-134-823,
	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-03T02:19:07.0993738-04:00,
	Device: Desktop
}