{
  "name": "Ownership Tracing API",
  "version": "3.0.0",
  "endpoints": {
    "entities": {
      "url": "/entities",
      "description": "List/search entities (params: q, country, limit, offset)"
    },
    "entities_detail": {
      "url": "/entities/{id}",
      "description": "Get entity details"
    },
    "entities_owners": {
      "url": "/entities/{id}/owners",
      "description": "Direct owners of an entity"
    },
    "entities_owned": {
      "url": "/entities/{id}/owned",
      "description": "Entities directly owned"
    },
    "entities_trace_up": {
      "url": "/entities/{id}/trace/up",
      "description": "Paths to terminal ancestors"
    },
    "entities_trace_down": {
      "url": "/entities/{id}/trace/down",
      "description": "Paths to terminal descendants"
    },
    "assets": {
      "url": "/assets",
      "description": "List/search assets (params: q, status, country, asset_type, limit, offset)"
    },
    "assets_detail": {
      "url": "/assets/{id}",
      "description": "Get asset details"
    },
    "ownership_graph": {
      "url": "/ownership/graph",
      "description": "Unified graph traversal (params: root, direction=up|down, max_depth)"
    },
    "catalog_sources": {
      "url": "/catalog/sources",
      "description": "List data sources"
    },
    "catalog_field_mappings": {
      "url": "/catalog/field-mappings",
      "description": "List field mappings"
    },
    "catalog_metadata": {
      "url": "/catalog/metadata",
      "description": "Tracker metadata (fields, types, allowed values)"
    },
    "catalog_asset_classes": {
      "url": "/catalog/asset-classes",
      "description": "Asset class definitions with API filter params"
    },
    "owners": {
      "url": "/owners",
      "description": "Owner aggregation across assets (params: asset_type, status, country, owner_entity_id, asset_id, limit, offset)"
    },
    "resolve": {
      "url": "/resolve/{id}",
      "description": "Universal GEM ID resolver — any prefix (G, U, L, P, M)"
    },
    "locations": {
      "url": "/locations/{id}",
      "description": "Location detail (all units at a location)"
    },
    "segments": {
      "url": "/segments",
      "description": "Pre-built query segments for asset data"
    },
    "metadata": {
      "url": "/metadata",
      "description": "Deployment metadata (version, build info, database stats)"
    }
  }
}