territory EntityType

Territory represents sales regions.

Entity Set Path
[organization URI]/api/data/v9.0/territories
Base Type
Display Name
Primary Key
Primary Key Attribute
Operations Supported


Properties represent fields of data stored in the entity.Some properties are read-only.

Name Type Details
createdon Edm.DateTimeOffset

Date and time when the record was created.

Display Name: Created On

Read Only
description Edm.String

Description of the territory.

Display Name: Description

entityimage Edm.Binary

The default image for the entity.

Display Name: Entity Image

entityimage_timestamp Edm.Int64
Read Only
entityimage_url Edm.String
Read Only
entityimageid Edm.Guid
Read Only
exchangerate Edm.Decimal

Exchange rate for the currency associated with the territory with respect to the base currency.

Display Name: Exchange Rate

Read Only
importsequencenumber Edm.Int32

Sequence number of the import that created this record.

Display Name: Import Sequence Number

modifiedon Edm.DateTimeOffset

Date and time when the record was modified.

Display Name: Modified On

Read Only
name Edm.String

Name of the territory.

Display Name: Territory Name

overriddencreatedon Edm.DateTimeOffset

Date and time that the record was migrated.

Display Name: Record Created On

territoryid Edm.Guid

Unique identifier of the territory.

Display Name: Territory

timezoneruleversionnumber Edm.Int32

For internal use only.

Display Name: Time Zone Rule Version Number

utcconversiontimezonecode Edm.Int32

Time zone code that was in use when the record was created.

Display Name: UTC Conversion Time Zone Code

versionnumber Edm.Int64

Version Number

Display Name: Version Number

Read Only

Lookup Properties

Lookup properties are read-only, computed properties which contain entity primary key Edm.Guid data for one or more corresponding single-valued navigation properties. More information: Lookup properties and Retrieve data about lookup properties.

Name Single-valued navigation property Description
_createdby_value createdby

Unique identifier of the user who created the territory.

_createdonbehalfby_value createdonbehalfby

Unique identifier of the delegate user who created the territory.

_managerid_value managerid

Unique identifier of the manager of the territory.

_modifiedby_value modifiedby

Unique identifier of the user who last modified the territory.

_modifiedonbehalfby_value modifiedonbehalfby

Unique identifier of the delegate user who last modified the territory.

_organizationid_value organizationid

Unique identifier for the organization

_parentterritoryid_value parentterritoryid

Choose the parent for this territory.

_transactioncurrencyid_value transactioncurrencyid

Unique identifier of the currency associated with the territory.

Single-valued navigation properties

Single-valued navigation properties represent lookup fields where a single entity can be referenced. Each single-valued navigation property has a corresponding partner collection-valued navigation property on the related entity.

Name Type Partner
createdby systemuser lk_territorybase_createdby
createdonbehalfby systemuser lk_territory_createdonbehalfby
managerid systemuser system_user_territories
modifiedby systemuser lk_territorybase_modifiedby
modifiedonbehalfby systemuser lk_territory_modifiedonbehalfby
organizationid organization organization_territories
parentterritoryid territory territory_parent_territory
transactioncurrencyid transactioncurrency TransactionCurrency_Territory

Collection-valued navigation properties

Collection-valued navigation properties represent collections of entities which may represent either a one-to-many (1:N) or many-to-many (N:N) relationship between the entities.

Name Type Partner
msdyn_territory_account_ServiceTerritory account msdyn_serviceterritory
msdyn_territory_msdyn_actual_ServiceTerritory msdyn_actual msdyn_ServiceTerritory
msdyn_territory_msdyn_agreement_ServiceTerritory msdyn_agreement msdyn_serviceterritory
msdyn_territory_msdyn_postalcode_ServiceTerritory msdyn_postalcode msdyn_serviceterritory
msdyn_territory_msdyn_resourcerequirement_Territory msdyn_resourcerequirement msdyn_Territory
msdyn_territory_msdyn_resourceterritory_Territory msdyn_resourceterritory msdyn_territory
msdyn_territory_msdyn_workorder_ServiceTerritory msdyn_workorder msdyn_serviceterritory
msdyn_territory_quotedetail_ServiceTerritory quotedetail msdyn_ServiceTerritory
territory_accounts account territoryid
Territory_AsyncOperations asyncoperation regardingobjectid_territory
Territory_BulkDeleteFailures bulkdeletefailure regardingobjectid_territory
territory_connections1 connection record1id_territory
territory_connections2 connection record2id_territory
Territory_DuplicateBaseRecord duplicaterecord baserecordid_territory
Territory_DuplicateMatchingRecord duplicaterecord duplicaterecordid_territory
territory_MailboxTrackingFolders mailboxtrackingfolder regardingobjectid_territory
territory_parent_territory territory parentterritoryid
territory_principalobjectattributeaccess principalobjectattributeaccess objectid_territory
Territory_ProcessSessions processsession regardingobjectid_territory
Territory_SyncErrors syncerror regardingobjectid_territory_syncerror
territory_system_users systemuser territoryid


The following solutions include the territory entity type.

Name Description
Field Service Microsoft Dynamics 365 for Field Service allows organizations of any size to deliver intelligent, world class field service, managing all aspects of the end-to-end field service management cycle. Features include scheduling, mobile, asset management, inventory control, customer notifications, and resource utilization controls that help maximize efficiency and minimize costs.
Territory Hierarchy Management For internal use only.
Application Common For internal use only.
Application Common Patch For internal use only.
Second Patch for Application Common For internal use only.

See also