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.