---
title: "Retrieve insertables by document ID and workspace or version ID."
method: GET
path: "/documents/d/{did}/{wv}/{wvid}/insertables"
tags: ["Document"]
---

# Retrieve insertables by document ID and workspace or version ID.

`GET /documents/d/{did}/{wv}/{wvid}/insertables`

## Path parameters

- `did` string, required
- `wv` string, required
- `wvid` string, required

## Query parameters

- `elementId` string
- `configuration` string
- `linkDocumentId` string
- `includeElementGroups` boolean
- `includeParts` boolean
- `includeSurfaces` boolean
- `includeSketches` boolean
- `includeReferenceFeatures` boolean
- `includeAssemblies` boolean
- `includeFeatureStudios` boolean
- `includeBlobs` boolean
- `allowedBlobMimeTypes` string
- `excludeNewerFSVersions` boolean
- `maxFeatureScriptVersion` integer
- `includePartStudios` boolean
- `includeFeatures` boolean
- `includeMeshes` boolean
- `includeWires` boolean
- `includeFlattenedBodies` boolean
- `includeApplications` boolean
- `allowedApplicationMimeTypes` string
- `includeCompositeParts` boolean
- `includeFSTables` boolean
- `includeFSComputedPartPropertyFunctions` boolean
- `includeVariables` boolean
- `includeVariableStudios` boolean
- `allowedBlobExtensions` string
- `isObsoletion` boolean

## Response `default`

default response

## Changes

- **2026-08-29** `5fa7a57a26dd` — 2 info
  - added the new optional `query` request parameter `includeElementGroups`
  - added the optional property `elementGroup` to the response with the `default` status

[Change history](https://skmtc.dev/onshape/apis/onshape-rest-api/changes/documents/d/:did/:wv/:wvid/insertables/get.md)

---

[API](https://skmtc.dev/onshape/apis/onshape-rest-api.md) · [All operations](https://skmtc.dev/onshape/apis/onshape-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/onshape/onshape-rest-api/revisions/5fa7a57a26dd/schema)