List providers

Live Macs at the gateway trust floor.

GET https://mifr-gateway-production.up.railway.app/v1/providers

cURL

curl https://mifr-gateway-production.up.railway.app/v1/providers \
  -H "Authorization: Bearer $MIFR_API_KEY"

200

[
  {
    "id": "prov_…",
    "model_ids": ["qwen3-4b"],
    "trust": "hardware",
    "busy": false,
    "waiting": 0,
    "serial": "C02…"
  }
]

This endpoint lists live Macs at the floor, with id, model_ids, trust, busy, waiting, and serial when the granted rung is hardware. Completions and this list send the full Apple-attested serial at hardware, so do not enroll a Mac whose serial must stay private.

Authorization · string · required

Bearer product key. Format: Bearer sk-mifr_….

Response

id · string

Provider key id. Pass this (or a unique prefix of at least 8 characters) as provider on a completion to pin that Mac.

model_ids · string[]

Catalog aliases this Mac currently advertises.

trust · string

Granted rung (hardware / transparent / process). The gateway only lists Macs at or above its floor.

busy · boolean

Whether the Mac is in a sealed session. A provider still serves one session at a time.

waiting · number

Queue depth in front of this Mac.

serial · string

Full Apple-attested serial. Present at hardware.

If the directory cannot list, the gateway returns 502 directory_unavailable with mifr_action: wait.

cURL

curl https://mifr-gateway-production.up.railway.app/v1/providers \
  -H "Authorization: Bearer $MIFR_API_KEY"

200

[
  {
    "id": "prov_…",
    "model_ids": ["qwen3-4b"],
    "trust": "hardware",
    "busy": false,
    "waiting": 0,
    "serial": "C02…"
  }
]