Azure Cosmos DB REST API

API Endpoints

Code Examples

curl -X GET \
  'https://mycosmosaccount.documents.azure.com/dbs' \
  -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGc...' \
  -H 'x-ms-date: Thu, 27 Apr 2024 00:00:00 GMT' \
  -H 'x-ms-version: 2018-12-31' \
  -H 'Content-Type: application/json'

const cosmosEndpoint = 'https://mycosmosaccount.documents.azure.com';
const authToken = 'eyJ0eXAiOiJKV1QiLCJhbGc...';

const response = await fetch(`${cosmosEndpoint}/dbs/mydb/colls/mycollection/docs`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${authToken}`,
    'Content-Type': 'application/json',
    'x-ms-date': new Date().toUTCString(),
    'x-ms-version': '2018-12-31',
    'x-ms-documentdb-partitionkey': '["partitionValue"]'
  },
  body: JSON.stringify({
    id: 'doc123',
    name: 'John Doe',
    email: 'john@example.com'
  })
});

const data = await response.json();
console.log(data);

import requests
from datetime import datetime

endpoint = 'https://mycosmosaccount.documents.azure.com'
auth_token = 'eyJ0eXAiOiJKV1QiLCJhbGc...'

headers = {
    'Authorization': f'Bearer {auth_token}',
    'Content-Type': 'application/json',
    'x-ms-date': datetime.utcnow().strftime('%a, %d %b %Y %H:%M:%S GMT'),
    'x-ms-version': '2018-12-31',
    'x-ms-documentdb-query-enablecrosspartition': 'true'
}

query = {
    'query': 'SELECT * FROM c WHERE c.email = @email',
    'parameters': [{'name': '@email', 'value': 'john@example.com'}]
}

response = requests.post(
    f'{endpoint}/dbs/mydb/colls/mycollection/docs',
    headers=headers,
    json=query
)

print(response.json())

Related APIs