competitor EntityType

Business competing for the sale represented by a lead or opportunity.

Entity Set Path
[organization URI]/api/data/v9.0/competitors
Base Type
crmbaseentity
Display Name
Competitor
Primary Key
competitorid
Primary Key Attribute
name
Operations Supported
POST GET PATCH DELETE

Properties

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

Name Type Details
address1_addressid Edm.Guid

Unique identifier for address 1.

Display Name: Address 1: ID

address1_addresstypecode Edm.Int32

Select the primary address type.

Display Name: Address 1: Address Type

Default Options
Value Label
1 Default Value
address1_city Edm.String

Type the city for the primary address.

Display Name: City

address1_composite Edm.String

Shows the complete primary address.

Display Name: Address 1

Read Only
address1_country Edm.String

Type the country or region for the primary address.

Display Name: Country/Region

address1_county Edm.String

Type the county for the primary address.

Display Name: Address 1: County

address1_fax Edm.String

Type the fax number associated with the primary address.

Display Name: Address 1: Fax

address1_latitude Edm.Double

Type the latitude value for the primary address for use in mapping and other applications.

Display Name: Address 1: Latitude

address1_line1 Edm.String

Type the first line of the primary address.

Display Name: Street 1

address1_line2 Edm.String

Type the second line of the primary address.

Display Name: Street 2

address1_line3 Edm.String

Type the third line of the primary address.

Display Name: Street 3

address1_longitude Edm.Double

Type the longitude value for the primary address for use in mapping and other applications.

Display Name: Address 1: Longitude

address1_name Edm.String

Type a descriptive name for the primary address, such as Corporate Headquarters.

Display Name: Address 1: Name

address1_postalcode Edm.String

Type the ZIP Code or postal code for the primary address.

Display Name: ZIP/Postal Code

address1_postofficebox Edm.String

Type the post office box number of the primary address.

Display Name: Address 1: Post Office Box

address1_shippingmethodcode Edm.Int32

Select a shipping method for deliveries sent to this address.

Display Name: Address 1: Shipping Method

Default Options
Value Label
1 Default Value
address1_stateorprovince Edm.String

Type the state or province of the primary address.

Display Name: State/Province

address1_telephone1 Edm.String

Type the main phone number associated with the primary address.

Display Name: Address 1: Telephone 1

address1_telephone2 Edm.String

Type a second phone number associated with the primary address.

Display Name: Address 1: Telephone 2

address1_telephone3 Edm.String

Type a third phone number associated with the primary address.

Display Name: Address 1: Telephone 3

address1_upszone Edm.String

Type the UPS zone of the primary address to make sure shipping charges are calculated correctly and deliveries are made promptly, if shipped by UPS.

Display Name: Address 1: UPS Zone

address1_utcoffset Edm.Int32

Select the time zone, or UTC offset, for this address so that other people can reference it when they contact someone at this address.

Display Name: Address 1: UTC Offset

address2_addressid Edm.Guid

Unique identifier for address 2.

Display Name: Address 2: ID

address2_addresstypecode Edm.Int32

Select the secondary address type.

Display Name: Address 2: Address Type

Default Options
Value Label
1 Default Value
address2_city Edm.String

Type the city for the secondary address.

Display Name: Address 2: City

address2_composite Edm.String

Shows the complete secondary address.

Display Name: Address 2

Read Only
address2_country Edm.String

Type the country or region for the secondary address.

Display Name: Address 2: Country/Region

address2_county Edm.String

Type the county for the secondary address.

Display Name: Address 2: County

address2_fax Edm.String

Type the fax number associated with the secondary address.

Display Name: Address 2: Fax

address2_latitude Edm.Double

Type the latitude value for the secondary address for use in mapping and other applications.

Display Name: Address 2: Latitude

address2_line1 Edm.String

Type the first line of the secondary address.

Display Name: Address 2: Street 1

address2_line2 Edm.String

Type the second line of the secondary address.

Display Name: Address 2: Street 2

address2_line3 Edm.String

Type the third line of the secondary address.

Display Name: Address 2: Street 3

address2_longitude Edm.Double

Type the longitude value for the secondary address for use in mapping and other applications.

Display Name: Address 2: Longitude

address2_name Edm.String

Type a descriptive name for the secondary address, such as Corporate Headquarters.

Display Name: Address 2: Name

address2_postalcode Edm.String

Type the ZIP Code or postal code for the secondary address.

Display Name: Address 2: ZIP/Postal Code

address2_postofficebox Edm.String

Type the post office box number of the secondary address.

Display Name: Address 2: Post Office Box

address2_shippingmethodcode Edm.Int32

Select a shipping method for deliveries sent to this address.

Display Name: Address 2: Shipping Method

Default Options
Value Label
1 Default Value
address2_stateorprovince Edm.String

Type the state or province of the secondary address.

Display Name: Address 2: State/Province

address2_telephone1 Edm.String

Type the main phone number associated with the secondary address.

Display Name: Address 2: Telephone 1

address2_telephone2 Edm.String

Type a second phone number associated with the secondary address.

Display Name: Address 2: Telephone 2

address2_telephone3 Edm.String

Type a third phone number associated with the secondary address.

Display Name: Address 2: Telephone 3

address2_upszone Edm.String

Type the UPS zone of the secondary address to make sure shipping charges are calculated correctly and deliveries are made promptly , if shipped by UPS.

Display Name: Address 2: UPS Zone

address2_utcoffset Edm.Int32

Select the time zone, or UTC offset, for this address so that other people can reference it when they contact someone at this address.

Display Name: Address 2: UTC Offset

competitorid Edm.Guid

Unique identifier of the competitor.

Display Name: Competitor

createdon Edm.DateTimeOffset

Date and time when the record was created.

Display Name: Created On

Read Only
entityimage Edm.Binary

Shows the default image for the record.

Display Name: Entity Image

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

Shows the conversion rate of the record's currency. The exchange rate is used to convert all money fields in the record from the local currency to the system's default currency.

Display Name: Exchange Rate

Read Only
importsequencenumber Edm.Int32

Sequence number of the import that created this record.

Display Name: Import Sequence Number

keyproduct Edm.String

Type the competitor's primary product, service, or specialty.

Display Name: Key Product

modifiedon Edm.DateTimeOffset

Date and time when the record was modified.

Display Name: Modified On

Read Only
name Edm.String

Type the company or business name used to identify the competitor in data views and related records.

Display Name: Name

opportunities Edm.String

Type notes or other information about the competitive opportunities or selling points you can make.

Display Name: Opportunity

overriddencreatedon Edm.DateTimeOffset

Date and time that the record was migrated.

Display Name: Record Created On

overview Edm.String

Type notes or other information about the competitor's business, such as location, revenue, or distribution channel.

Display Name: Overview

processid Edm.Guid

Contains the id of the process associated with the entity.

Display Name: Process Id

referenceinfourl Edm.String

Type the URL for the website used to obtain reference information about the competitor.

Display Name: Reference Info URL

reportedrevenue Edm.Decimal

Type the amount of revenue reported in the competitor's annual report or other source.

Display Name: Reported Revenue

reportedrevenue_base Edm.Decimal

Value of the Reported Revenue in base currency.

Display Name: Reported Revenue (Base)

Read Only
reportingquarter Edm.Int32

Type the quarter number during which the competitor's reported revenue was recorded or announced for use in reporting and analysis.

Display Name: Reporting Quarter

reportingyear Edm.Int32

Type the fiscal year during which the competitor's reported revenue was announced for use in reporting and analysis.

Display Name: Reporting Year

stageid Edm.Guid

Contains the id of the stage where the entity is located.

Display Name: Stage Id

stockexchange Edm.String

Type the stock exchange at which the competitor is listed to track their stock and financial performance of the company.

Display Name: Stock Exchange

strengths Edm.String

Type notes or other information about the competitor's strengths, such as top-selling products and targeted industries or markets.

Display Name: Strength

threats Edm.String

Type notes or other information about the competitor's threats to your organization when you sell to the same prospect or customer.

Display Name: Threat

tickersymbol Edm.String

Type the stock exchange symbol for the competitor to track financial performance of the company. You can click the code entered in this field to access the latest trading information from MSN Money.

Display Name: Ticker Symbol

timezoneruleversionnumber Edm.Int32

For internal use only.

Display Name: Time Zone Rule Version Number

traversedpath Edm.String

A comma separated list of string values representing the unique identifiers of stages in a Business Process Flow Instance in the order that they occur.

Display Name: Traversed Path

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
weaknesses Edm.String

Type notes or other information about the competitor's weaknesses or areas in which your organization outperforms the competitor.

Display Name: Weakness

websiteurl Edm.String

Type the website URL for the competitor.

Display Name: Website

winpercentage Edm.Double

Type the percentage of your organization's lost opportunities that are won by the competitor to identify your strongest competitors.

Display Name: Win Percentage

yominame Edm.String

Type the phonetic spelling of the competitor's name, if specified in Japanese, to make sure the name is pronounced correctly in phone calls and other communications.

Display Name: Yomi Name

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

Shows who created the record.

_createdonbehalfby_value createdonbehalfby

Shows who created the record on behalf of another user.

_modifiedby_value modifiedby

Shows who last updated the record.

_modifiedonbehalfby_value modifiedonbehalfby

Shows who last updated the record on behalf of another user.

_organizationid_value organizationid

Unique identifier for the organization

_transactioncurrencyid_value transactioncurrencyid

Choose the local currency for the record to make sure budgets are reported in the correct currency.

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_competitorbase_createdby
createdonbehalfby systemuser lk_competitor_createdonbehalfby
modifiedby systemuser lk_competitorbase_modifiedby
modifiedonbehalfby systemuser lk_competitor_modifiedonbehalfby
organizationid organization organization_competitors
stageid_processstage processstage processstage_competitors
transactioncurrencyid transactioncurrency transactioncurrency_competitor

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
competitor_addresses competitoraddress parentid
Competitor_Annotation annotation objectid_competitor
Competitor_AsyncOperations asyncoperation regardingobjectid_competitor
Competitor_BulkDeleteFailures bulkdeletefailure regardingobjectid_competitor
competitor_connections1 connection record1id_competitor
competitor_connections2 connection record2id_competitor
Competitor_DuplicateBaseRecord duplicaterecord baserecordid_competitor
Competitor_DuplicateMatchingRecord duplicaterecord duplicaterecordid_competitor
competitor_MailboxTrackingFolders mailboxtrackingfolder regardingobjectid_competitor
competitor_opportunity_activities opportunityclose competitorid
competitor_PostFollows postfollow regardingobjectid_competitor
competitor_PostRegardings postregarding regardingobjectid_competitor
competitor_principalobjectattributeaccess principalobjectattributeaccess objectid_competitor
Competitor_ProcessSessions processsession regardingobjectid_competitor
Competitor_SyncErrors syncerror regardingobjectid_competitor_syncerror
competitorproduct_association product competitorproduct_association
competitorsalesliterature_association salesliterature competitorsalesliterature_association
leadcompetitors_association lead leadcompetitors_association
opportunitycompetitors_association opportunity opportunitycompetitors_association

Solutions

The following solutions include the competitor entity type.

Name Description
App for Outlook
Sales Dynamics 365 workload for sales.

See also