The Azure DocumentDB REST API is a REST-based API that provides programmatic access to DocumentDB resources to create, query, and delete databases, document collections, and documents programmatically. Azure DocumentDB is a fast and flexible NoSQL database service that is used for storing high-volume transactional and operational data with predictable single-digit millisecond latency for reads and writes. This makes it well-suited for IoT, gaming, retail, and operational logging applications.
To perform operations on DocumentDB resources, you send HTTPS requests with a supported method: GET, POST, PUT, or DELETE to an endpoint that targets a resource collection or a specific resource. This section contains information about working with resources by using the REST API.
Supported REST API Versions
The following table lists the supported REST API versions by the Azure DocumentDB service. The version must be specified via the
x-ms-version header in every request. If not specified, the service defaults to the latest version
|Version||Change introduced||Retirement date|
|2015-06-03||Order By support|
|2015-04-08||DocumentDB general availability|
|2014-08-21||DocumentDB public preview||February 29th, 2016|
The following articles describe the supported REST APIs for each resource type. For general information about DocumentDB resources, see Interact with DocumentDB Resources and DocumentDB Resource URI Syntax for REST.
- Stored Procedures
- User Defined Functions
See Access Control on DocumentDB Resources for how to authorize requests to DocumentDB. For general information about DocumentDB request and response options, see the following articles:
- Status Codes for DocumentDB
- Common DocumentDB REST request headers
- Common DocumentDB REST response headers
- Common tasks using the DocumentDB REST API