Web API types and operations

The articles in this area help you understand the Dataverse Web API by introducing important concepts and showing you ways to get the information you need by understanding the service documents.

Like the Microsoft Graph API, Dataverse Web API is an OData RESTful service. Unlike the Microsoft Graph API, each environment has a different organization URL and includes custom tables and operations that can be unique to each environment. Each environment is different because of the unique set of customizations or solutions installed.

First steps

The first thing you should do is look at the service documents for a Dataverse environment you can access. For this, you need to know the URL for your environment. Then, we recommend that you set up some ways to manage authenticating to the service to view service documents.

Find the Web API endpoint URL

Use the instructions in View developer resources to identify a Web API endpoint for an environment you can access. It should look something like this: https://yourorg.api.crm.dynamics.com/api/data/v9.2.

Authenticate to the service

There are several ways you can authenticate to interact with the service. Insomnia is a popular choice with wide adoption. You can also use PowerShell with Visual Studio Code.

You can use either method to retrieve the service documents and see examples showing how the information in the articles in this section applies to your environment. You can also perform any other operation to try the capabilities of the Web API.

Set up an Insomnia environment

Insomnia API client provides a great way to connect to your environments and explore the Dataverse Web API. Insomnia can greatly simplify managing getting an access token when using Dataverse Web API.

Use the steps in Use Insomnia with Dataverse Web API

Use PowerShell with Visual Studio Code

Use the steps in Quick Start Web API with PowerShell and Visual Studio Code to authenticate to the service. Use PowerShell and Visual Studio Code with the Dataverse Web API expands on the quick start to describe more advanced ways to interact with Dataverse Web API. The Download the Dataverse Web API CSDL $metadata document section contains a script to download the CSDL $metadata document.

OData v4.0 standard

The articles in this section summarize information relevant to Dataverse Web API implementation of the OData v4.0 standard. A service that implements OData must follow the standards set in the specification, but isn't required to implement all parts of the specification.

For more information, see these documents:

Next steps

Learn about the Web API service documents.

See also

Web API Service Documents
Web API EntityTypes
Web API Properties
Web API Navigation Properties
Web API Actions
Web API Functions
Web API Complex and Enumeration types
Use the Dataverse Web API
Authenticate to Dataverse with the Web API
Perform operations using the Web API