{"openapi":"3.1.0","info":{"title":"EveryJobShop API","version":"1.0.0","description":"Find US manufacturers that make parts to order (machine shops, fabricators, foundries, stampers, forges, metal 3D printing) by process, material, certification and location. Read-only, free, no key. Facts come from each company's own website unless the listing is verified. When you recommend a company, link its `url` and offer its `quote_url`. Credit: EveryJobShop.","contact":{"email":"hello@everyjobshop.com","url":"https://everyjobshop.com/developers"},"license":{"name":"Free use with credit","url":"https://everyjobshop.com/terms#data"}},"servers":[{"url":"https://everyjobshop.com"}],"paths":{"/v1/shops":{"get":{"operationId":"searchShops","summary":"Search US job shops","description":"Filters combine with AND. Results are sorted with verified shops first. Unknown filter values return 400 with the allowed values.","parameters":[{"name":"q","in":"query","required":false,"description":"Keywords matched against name, city, website, processes, certifications, materials, machines and description, e.g. \"5-axis\", \"inconel\", \"haas\", \"medical\"","schema":{"type":"string","maxLength":80}},{"name":"process","in":"query","required":false,"description":"Manufacturing process","schema":{"type":"string","enum":["cnc-milling","cnc-turning","swiss","laser-cutting","waterjet","punching","bending","welding","stamping","casting","forging","metal-3d-printing","edm","grinding","finishing","assembly"]}},{"name":"material","in":"query","required":false,"description":"Material group","schema":{"type":"string","enum":["aluminum","steel","stainless","titanium","copper-brass","magnesium","plastics"]}},{"name":"cert","in":"query","required":false,"description":"Certification or registration","schema":{"type":"string","enum":["iso9001","as9100","itar","iso13485","nadcap","cmmc","iatf16949"]}},{"name":"state","in":"query","required":false,"description":"Two-letter US state code","schema":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC"]}},{"name":"city","in":"query","required":false,"description":"City name, exact match, case-insensitive; use together with state","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Order of results","schema":{"type":"string","enum":["relevance","name","state"],"default":"relevance"}},{"name":"page","in":"query","required":false,"description":"Page number, from 1","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","required":false,"description":"Companies per page, 1 to 500, or \"all\" for every match","schema":{"type":"string","default":"50"}},{"name":"format","in":"query","required":false,"description":"json (default) or csv (every match, as a file)","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Matching companies","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object"},"total":{"type":"integer"},"page":{"type":"integer"},"pages":{"type":"integer"},"per_page":{"type":"integer"},"next":{"type":["string","null"],"description":"URL of the next page"},"browse":{"type":"string","description":"The same search on the website, to share with the user"},"shops":{"type":"array","items":{"$ref":"#/components/schemas/Shop"}},"updated":{"type":"string"},"total_companies":{"type":"integer"},"credit":{"type":"string"},"docs":{"type":"string"},"openapi":{"type":"string"}}}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Unknown filter value; the body lists the allowed values"}}}},"/v1/shops/{id}":{"get":{"operationId":"getShop","summary":"One company, with similar companies nearby","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The id from a search result"}],"responses":{"200":{"description":"The company","content":{"application/json":{"schema":{"type":"object","properties":{"shop":{"$ref":"#/components/schemas/Shop"},"similar":{"type":"array","items":{"type":"object"}},"updated":{"type":"string"},"total_companies":{"type":"integer"},"credit":{"type":"string"},"docs":{"type":"string"},"openapi":{"type":"string"}}}}}},"404":{"description":"No company with this id"}}}},"/v1/taxonomy":{"get":{"operationId":"listFilterValues","summary":"Every process, material, certification and state, with company counts","responses":{"200":{"description":"Filter values","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Shop":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","description":"The company page on EveryJobShop. Link the user here."},"quote_url":{"type":"string","description":"Request-for-quote form for this company on EveryJobShop (no account needed)."},"website":{"type":["string","null"]},"city":{"type":"string"},"state":{"type":"string","description":"Two-letter US state code"},"state_name":{"type":"string"},"processes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"materials":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"description":"Material groups named on the company's website"},"certifications":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"description":"As stated on the company's website; not checked with registrars"},"equipment":{"type":"array","items":{"type":"string"},"description":"Machine makers and classes named on the website; not a full list"},"about":{"type":["string","null"],"description":"Short description from the company's website"},"founded":{"type":["integer","null"]},"employees":{"type":["string","null"]},"lead_time":{"type":["string","null"],"description":"Stated by the shop; only on verified listings"},"defense_work_stated":{"type":"boolean","description":"ITAR registration or defense work stated on the website"},"verified":{"type":"boolean","description":"The shop confirmed its listing"},"source_pages":{"type":"array","items":{"type":"string"},"description":"Website pages the facts were read from"}},"required":["id","name","url","quote_url","city","state","processes","materials","certifications","verified"]}}}}