Skip to main content

Countries

EntityDatastoreDatastore.Country

Countries are used in addresses and for VAT group configuration. They can contain states/provinces.

Use the Datastore_Country endpoint to query countries.

Endpoints

List Countries

GET/v1/odata/Datastore_Country

Single Countrie

GET/v1/odata/Datastore_Country({id})

Fields

Datastore Fields (inherited)

FieldTypeDescription
NameStringDisplay name
CodeStringUnique code identifier
LocalizedNameStringLocalized display name
IsDefaultBooleanWhether this is the default value

Countries Fields

FieldTypeDescription
HasIntraCommunityVatBooleanHasIntraCommunityVat
CountryNumberStringCountryNumber

Relationships

RelationshipTarget EntityCardinalityDescription
AddressAddress1:NAddress
VatGroupDatastore_VatGroup1:NVatGroup
StatesDatastore_State1:NStates

Expanding Relationships

GET/v1/odata/Datastore_Country({id})?$expand=Address
GET/v1/odata/Datastore_Country({id})/Address

Filtering Examples

GET/v1/odata/Datastore_Country?$filter=Name eq '{Name}'&$top={top}
GET/v1/odata/Datastore_Country?$filter=contains(Name, '{Name}')&$top={top}
GET/v1/odata/Datastore_Country?$filter=Code eq '{Code}'&$top={top}
GET/v1/odata/Datastore_Country?$filter=IsDefault eq {IsDefault}&$top={top}