{
  "aid": "drata.com:main-V2",
  "name": "Drata API – Beta 🧪",
  "type": "Index",
  "description": "### Beta Status\nWe've made API version 2 available for beta testing. We would appreciate [your feedback](https://docs.google.com/forms/d/e/1FAIpQLScDt_FYcc5jDKzjGDxOdopsjgq4AipEVQ18E0c0Ki7em-ubCw/viewform?usp=header).\n[Drata API version 1 is still available](https://developers.drata.com/openapi/reference/v1/overview/).\n\n### What's New in V2\n- Support for Custom Fields\n- Get and acknowledge user's assigned policies\n- Payloads are streamlined to include only the essential information. You can expand related objects and collections using the `expand` query parameter.\n- Cursor-based pagination for greater efficiency and stability with large datasets\n\n### Getting Started\nPlease visit our help article to learn how to [create an API key](https://help.drata.com/en/articles/6695964).\n\n### Upgrading From Version 1\nAPI V2 is designed to provide a faster an more flexible way of accessing Drata. There are several differences from V1:\n- The listing endpoints now use **cursor-based pagination**. This provides faster responses and ensures that all records can be retrieved even, if they are changed during the process.\n\n```javascript\nasync function fetchAll() {\n  // The first request doesn't send a value for the cursor.\n  let cursor = undefined;\n  do {\n    const query = new URLSearchParams({ cursor });\n    const resp = await fetch(\n      `https://public-api.drata.com/public/v2/users?${query}`,\n      {\n        method: 'GET',\n        headers: { Authorization: 'Bearer <YOUR_API_KEY_HERE>' }\n      }\n    );\n    const data = await resp.json();\n    console.log(data);\n\n    // If there's a cursor value returned, then there are more results.\n    // Pass that back as a query parameter to get the next page of data.\n    cursor = data?.pagination?.cursor;\n  } while (cursor)\n}\nfetchAll();\n```\n- You'll notice smaller responses. Most endpoints accept an `expand` query parameter that let's you specify which related objects and collections you want to expand.\n",
  "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/drata.com/main/V2/apis.json",
  "tags": [
    "drata.com",
    "main"
  ],
  "created": "2026-03-19",
  "modified": "2026-03-19",
  "specificationVersion": "0.19",
  "access": "3rd-Party",
  "maintainers": [
    {
      "FN": "Jentic",
      "X-github": "jentic",
      "url": "https://github.com/jentic"
    }
  ],
  "apis": [
    {
      "aid": "drata.com:main-V2",
      "name": "Drata API – Beta 🧪",
      "description": "### Beta Status\nWe've made API version 2 available for beta testing. We would appreciate [your feedback](https://docs.google.com/forms/d/e/1FAIpQLScDt_FYcc5jDKzjGDxOdopsjgq4AipEVQ18E0c0Ki7em-ubCw/viewform?usp=header).\n[Drata API version 1 is still available](https://developers.drata.com/openapi/reference/v1/overview/).\n\n### What's New in V2\n- Support for Custom Fields\n- Get and acknowledge user's assigned policies\n- Payloads are streamlined to include only the essential information. You can expand related objects and collections using the `expand` query parameter.\n- Cursor-based pagination for greater efficiency and stability with large datasets\n\n### Getting Started\nPlease visit our help article to learn how to [create an API key](https://help.drata.com/en/articles/6695964).\n\n### Upgrading From Version 1\nAPI V2 is designed to provide a faster an more flexible way of accessing Drata. There are several differences from V1:\n- The listing endpoints now use **cursor-based pagination**. This provides faster responses and ensures that all records can be retrieved even, if they are changed during the process.\n\n```javascript\nasync function fetchAll() {\n  // The first request doesn't send a value for the cursor.\n  let cursor = undefined;\n  do {\n    const query = new URLSearchParams({ cursor });\n    const resp = await fetch(\n      `https://public-api.drata.com/public/v2/users?${query}`,\n      {\n        method: 'GET',\n        headers: { Authorization: 'Bearer <YOUR_API_KEY_HERE>' }\n      }\n    );\n    const data = await resp.json();\n    console.log(data);\n\n    // If there's a cursor value returned, then there are more results.\n    // Pass that back as a query parameter to get the next page of data.\n    cursor = data?.pagination?.cursor;\n  } while (cursor)\n}\nfetchAll();\n```\n- You'll notice smaller responses. Most endpoints accept an `expand` query parameter that let's you specify which related objects and collections you want to expand.\n",
      "image": "",
      "baseURL": "https://public-api.drata.com/public/v2",
      "humanURL": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/drata.com/main/V2",
      "version": "V2",
      "tags": [
        "drata.com",
        "main"
      ],
      "properties": [
        {
          "type": "OpenAPI",
          "name": "OpenAPI definition",
          "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/drata.com/main/V2/openapi.json",
          "mediaType": "application/openapi+json"
        },
        {
          "type": "GitHubRepo",
          "url": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/drata.com/main/V2"
        }
      ]
    }
  ]
}