{
 "openapi": "3.0.3",
 "info": {
  "title": "Xem Studio geometry API",
  "version": "2026-10-20",
  "description": "Free dimension sheets, free generated hardware STEP/STL, and a license-aware index of public CAD for real objects. Same data over MCP (Streamable HTTP, no auth) at https://xemstudio.com/mcp. Paid mesh/STEP downloads via x402 are planned and will return 402 with payment details. All geometry on Xem Studio is exact (nominal, true size) with no tolerance added. Where a part meets another part, the object lists its mating features (feature, exact size, what it mates with, fit class: press, slide, run, socket, clamp or designed). Apply your process's allowance to those features only; 'designed' gaps are part of the design and stay as drawn. Typical accuracy by process and ISO 286 fits: https://xemstudio.com/tolerances/ Objects carry `mating` (feature, exact, mates, fit, files) and `fit_classes`."
 },
 "servers": [
  {
   "url": "https://xemstudio.com"
  }
 ],
 "paths": {
  "/api/geometry": {
   "get": {
    "summary": "List objects, fetch one, or search",
    "parameters": [
     {
      "name": "object",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Object slug, e.g. echo-dot-5"
     },
     {
      "name": "q",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Free-text search over names, aliases, tags, category and group"
     },
     {
      "name": "kind",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "modern",
        "vintage",
        "standard",
        "hardware"
       ]
      }
     },
     {
      "name": "category",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "3D printable tri-clamp",
        "3D printing",
        "Aircraft design",
        "Airfoils",
        "Audio & music",
        "Boat design",
        "Cameras & lenses",
        "Car design",
        "Computers & desk",
        "Drone design",
        "Drones",
        "Electronic components",
        "Electronics",
        "Everyday objects",
        "Hardware",
        "Home & kitchen",
        "Joinery",
        "Mechanisms",
        "Phones, tablets & wearables",
        "RC boats",
        "RC cars",
        "RC planes",
        "Sports & outdoors",
        "Storage systems",
        "TV, gaming & smart home",
        "Tools & garage",
        "Tri-clamp & pipe"
       ]
      }
     },
     {
      "name": "group",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "3D-print connectors",
        "AMS & dryers",
        "Action & 360 cameras",
        "Akro-Mils",
        "Apple Watch",
        "Audio interfaces",
        "Baby",
        "Batteries & cells",
        "Battery packs",
        "Bearings & hardware",
        "Bearings, rails & motion",
        "Beginner and toy boats",
        "Belt and friction drives",
        "Bench & craft machines",
        "Bikes & scooters",
        "Brewing & inline accessories",
        "Bridle joints",
        "Brushless outrunner motors",
        "Buggies, rally & street",
        "Building bricks",
        "Calibration & test prints",
        "Cams",
        "Canon RF lenses",
        "Caps & heads",
        "Caps, lids & ports",
        "Car aero",
        "Carbon tubes and spars",
        "Casters & wheels",
        "Catamarans",
        "Clamp fittings",
        "Clamps",
        "Clamps & fittings",
        "Coffee machines & capsules",
        "Coins",
        "Connectors",
        "Control surfaces",
        "Couplings & joints",
        "Crawlers & trail trucks",
        "Cutting tools",
        "DJI drones",
        "DeWalt ToughSystem & TSTAK",
        "Deep-V and mono racers",
        "Dell laptops",
        "Desk & streaming",
        "Diaphragms & membranes",
        "Docks, hubs & chargers",
        "Dovetail joints",
        "Dowel & loose tenon joints",
        "Drinkware, cans & bottles",
        "Drone frame layouts",
        "ESCs & servos",
        "Edge & case joints",
        "Escapements",
        "FDM printers",
        "FPV LiPo packs",
        "FPV cameras & video",
        "FPV frames",
        "FPV motors",
        "Fans",
        "Fasteners",
        "Festool Systainer\u00b3",
        "Filament spools",
        "Fishing rods",
        "Flashlights",
        "Flight controllers, ESCs & receivers",
        "Food storage containers",
        "Frames & stands",
        "Framing",
        "Fujifilm X",
        "Furniture & cabinet hardware",
        "Game consoles & controllers",
        "Garden & hydroponics",
        "Gears",
        "Gears, cranks & flywheels",
        "Generators & alternators",
        "Gimbals",
        "Google Pixel",
        "Ground-effect craft (built examples)",
        "Ground-effect design",
        "Guitar pedals",
        "Hand tool interfaces",
        "Hand tools",
        "Handles & tie-downs",
        "Headphones & earbuds",
        "Heat transfer",
        "Hinges & latches",
        "Home appliances",
        "Hotends & nozzles",
        "Household",
        "Hull types",
        "Hydroplanes and riggers",
        "IRIS WeatherPro",
        "Inserts & liners",
        "Intermittent motion",
        "Japanese joinery",
        "Jet boats",
        "Keyboard switches & stabilizers",
        "Keyboards & mice",
        "Keys & inlays",
        "Kitchen appliances",
        "Knobs, handles & feet",
        "L-BOXX",
        "Lap & halving joints",
        "Lens mounts & filter threads",
        "Lighting",
        "Linkages",
        "Linkages, wheels & connectors",
        "Mac desktops",
        "MacBook",
        "Machine tool tapers & collets",
        "Magnets & seals",
        "Magnets, plates & discs",
        "Materials & stock",
        "Mechanism parts",
        "Micro servos",
        "Microcontroller boards",
        "Microsoft Surface",
        "Milwaukee PACKOUT",
        "Mini & micro vehicles",
        "Mirrorless cameras",
        "Mitre joints",
        "Modules, sensors & displays",
        "Monitors",
        "Monster & bash trucks",
        "Mortise & tenon joints",
        "Motors",
        "Mounting standards",
        "Multimeters & clamp meters",
        "NACA 4-digit",
        "NACA 5-digit",
        "NACA 6-series",
        "Nikon Z lenses",
        "Other airfoils",
        "Other drones",
        "Other laptops",
        "Other phones",
        "Other tablets & e-readers",
        "Other tool storage",
        "Painting",
        "Panel cutouts",
        "Paper & cards",
        "Parts lists",
        "Pedalboards",
        "Personal care",
        "Pinions & spur gears",
        "Pipe, tube & threads",
        "Pistons, cylinders & rods",
        "Planes (RTF and kits)",
        "Portable speakers",
        "Power tool batteries & chargers",
        "Print-in-place mechanisms",
        "Printable fasteners",
        "Propellers",
        "Props and drive hardware",
        "Pulleys and tackle",
        "Reel seats",
        "Resin printers",
        "Rigging",
        "Rigging & lifting",
        "Rod grips & holders",
        "Routers & Wi-Fi",
        "SIM & memory cards",
        "Sailboat appendages",
        "Sailboats",
        "Samsung Galaxy phones",
        "Samsung Galaxy tablets",
        "Scale and tug models",
        "Scarf & splice joints",
        "Screws",
        "Screws & feeds",
        "Security cameras & doorbells",
        "Shopping carts",
        "Short course & stadium trucks",
        "Single-board computers",
        "Smart home",
        "Smart speakers & soundbars",
        "Smartwatches & wearables",
        "Sonos",
        "Sony E-mount lenses",
        "Sports balls",
        "Springs & flexures",
        "Sterilite",
        "Storage & NAS",
        "Streaming devices",
        "Suspension geometry",
        "Switches, relays & indicators",
        "Tail configurations",
        "ThinkPad",
        "Third-party lenses",
        "Tires & wheels",
        "Towing",
        "Trading card storage",
        "Vacuum flanges",
        "Vehicle",
        "Vessels",
        "Vintage forms",
        "Wall storage",
        "Wheel hexes",
        "Wing features",
        "Wing planforms",
        "Wireless microphones",
        "Wiring & connectors",
        "iPad",
        "iPhone"
       ]
      }
     },
     {
      "name": "year",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Exact year (2023), decade (2020s) or range (2010-2019); electronics and vintage objects only"
     },
     {
      "name": "free",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "1"
       ]
      },
      "description": "Only objects that are free end to end"
     },
     {
      "name": "categories",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "1"
       ]
      },
      "description": "Return the category/group tree with counts instead of objects"
     }
    ],
    "responses": {
     "200": {
      "description": "JSON: one object, or {objects:[...]}"
     },
     "404": {
      "description": "Unknown object"
     }
    }
   }
  }
 }
}