Machine Shop Directory API
Read-only JSON access to the shop listings in this directory. GET /api/shops is public and needs no API key.
How access works
- The endpoints below are public. Call them directly; there is no key and no signup.
- There is no self-serve key signup or checkout. For higher-volume or bulk access, a person sets it up by email: contact us or write to hello@machineshop.directory.
- CAGE codes come from the SAM.gov public extract. Certifications are labelled registry-confirmed or self-reported.
Endpoints
GET /api/shops
Active listings, paginated. Query parameters: page, limit (max 1000), search, state, city, service, material, certification.
GET /api/shops/{id}
One listing by the id returned from /api/shops. 404 when not found.
GET /api/docs
This API's OpenAPI 3.0 specification as JSON.
Example
curl 'https://machineshop.directory/api/shops?state=MA&service=CNC%20Machining&limit=20'
{
"shops": [
{ "id": "…", "name": "…", "slug": "…", "city": "…", "state": "MA",
"services": ["…"], "certifications": ["…"], "cageCode": "…" }
],
"pagination": { "page": 1, "limit": 20, "total": …, "totalPages": … }
}Response shape only; values are elided. Public responses may omit fields.
Interactive explorer
The interactive explorer loads here in your browser. The endpoints are documented above, and the raw OpenAPI spec is at /api/docs.