First Position Search

What you will build

You will search positions using the search API with criteria such as issuer, vehicle class, transferability, and valuation range. You will understand the result structure and how to refine searches.

Prerequisites

• Completed First API Call or Pull Inventory
• API key with positions:read scope

Steps to search positions by criteria

Call GET /positions/search (or the equivalent search endpoint) with query parameters. Common criteria include issuer_id, vehicle_class, transferable, min_valuation, max_valuation, status, and compliance_status. Combine filters to narrow results. Example:

curl -H "Authorization: Bearer $API_KEY" \
  "https://sandbox-api.dmtr.ai/v1/positions/search?vehicle_class=fund_lp&transferable=true"

Understanding results

Search results return a list of Position Objects matching your criteria. Results may be ranked by relevance or a default sort. Use limit and cursor for pagination. Each result includes full position data; filter or project fields client-side as needed.

curl -H "Authorization: Bearer $API_KEY" \
"https://sandbox-api.dmtr.ai/v1/positions/search?vehicle_class=fund_lp&transferable=true&min_valuation=500000"

{
  "data": [
    {
      "entity_id": "meg-2026-112",
      "asset": {
        "vehicle_class": "fund_lp",
        "issuer": "Sequoia Capital Fund XVIII"
      },
      "status": {
        "current": "active"
      },
      "transfer": {
        "transferable": true
      },
      "valuation": {
        "current_mark": 1250000
      }
    }
  ],
  "has_more": false
}

Next steps

• Execute Transfer Intent — Create and submit transfer intents
• Register First Position — End-to-end registration flow
• Build a Portfolio View — Aggregate and compose