Pull Inventory

What you will build

You will query the DMTR inventory (positions) via the API, apply filters such as vehicle class, and parse the results. This quickstart builds on the First API Call and introduces filtering and pagination.

Prerequisites

• Completed First API Call
• API key with positions:read scope

Steps to query inventory

Call GET /positions with optional query parameters. Use vehicle_class to filter by spv_llc, fund_lp, direct, etc. Use status to filter by active, pending, transferred. Use limit and cursor for pagination. Example:

curl -H "Authorization: Bearer $API_KEY" \
  "https://sandbox-api.dmtr.ai/v1/positions?vehicle_class=spv_llc&limit=50"

Filter by vehicle class

Pass vehicle_class=spv_llc for SPV LLC interests, vehicle_class=fund_lp for fund LP interests, vehicle_class=direct for direct holdings. Combine with other filters as needed. See the API reference for full parameter list.

Parse results

The response includes data (array of Position Objects), has_more, and next_cursor. Iterate through pages using the cursor. Each position has entity_id, asset.vehicle_class, asset.issuer, transfer.transferable, and more. Map to your internal models or display logic.

curl -H "Authorization: Bearer $API_KEY" \
"https://sandbox-api.dmtr.ai/v1/positions?vehicle_class=spv_llc&status=active&limit=10"

{
  "data": [
    {
      "entity_id": "meg-2026-047",
      "owner": "part-allocator-001",
      "asset": {
        "vehicle_class": "spv_llc",
        "issuer": {
          "name": "Acme Growth Fund III",
          "jurisdiction": "US-DE"
        }
      },
      "status": "active",
      "transfer": {
        "transferable": true,
        "restrictions": []
      }
    }
  ],
  "has_more": true,
  "next_cursor": "eyJpZCI6Im1lZy0yMDI2LTA0OCJ9"
}

Next steps

• First Position Search — Search by criteria
• Pagination — Cursor-based pagination details
• Build a Portfolio View — Aggregate and compose views