Do not use the OData v2.0 endpoint
Impact potential: High
There are no immediate symptoms, but code using this endpoint will stop working when the deprecated endpoint is removed.
We plan to remove this endpoint on November 11, 2022. OData v2.0 Service removal date announcement
You should change any code that depends on the Organization Data Service (OData v2.0) to use the Dataverse Web API (OData v4.0) endpoint instead.
The Organization Data Service uses this endpoint:
/XRMServices/2011/OrganizationData.svc. You should look for any active code using this endpoint.
sample_/Scripts/SDK.REST.js, which can be found here. The Xrm.WebApi (Client API reference) provides similar functions to create, update, delete, and retrieve records.
The Organization Data Service endpoint is also sometimes used by PowerShell scripts using Invoke-WebRequest.
Organization Data Service is an OData v2.0 endpoint introduced with Dynamics CRM 2011. It was deprecated with Dynamics 365 Customer Engagement v8.0. Also known as the OData endpoint or REST endpoint when it was released, this endpoint only provides the ability to perform create, retrieve, update, and delete operations on tables.
Both are OData endpoints, but there are differences in how they are implemented. Do not expect that existing code will work with only minor changes.
Some of the major differences are described below.
|Web API||Organization Data Service|
Organization Data Service uses
PUT rather than
Organization Data Service supports both JSON and ATOM. ATOM is an XML-based format usually used for RSS feeds. Web API only supports JSON.
Limits on number of records returned
Organization Data Service will only return 50 records at a time and doesn't provide a way to specify max page size.
Web API allows to set a max page size and will return up to 5000 records. More information: Limits on number of table rows (entities) returned.
Documentation describing the Organization Data Service is available here: Microsoft Dynamics 2015 SDK: Use the OData endpoint with web resources.
Submit and view feedback for