Know what your brand can actually run
The model catalogue says what the gateway can reach for somebody. One endpoint now says what YOUR subscriptions can serve right now, which ids to pin, and how many lease slots are free.
Your plans, not the whole catalogue
A catalogue of well over a thousand models is a statement about the gateway, not about you. GET /subscriptions returns one entry per credential your brand has vaulted, each with the concrete model ids you may pin. The brand comes from the credential, so there is no tenant parameter anywhere on the route to get wrong.
# Your own plans. No brand parameter exists on this route.
curl -H "Authorization: Bearer $CLIENT_ID:$API_KEY:$API_SECRET" \
"https://spideriq.ai/api/gate/v1/subscriptions"id
The name that works. Pass it as model.
provider_model_id
What the provider calls it. Informational.
cost_type
Flat-rate subscription, or metered per token.
health_status
Whether the credential itself is healthy.
Entitled is not the same as available
Two fields that sound like one claim. entitled means we permit it, computed with the same predicate the resolver uses, so it can never promise what routing would refuse. probe_status means we have seen the model answer, and null there means never probed rather than healthy. Measured on one brand: of 25 entitled models, 2 had been seen to answer.
entitled
We permit it. A claim about permission only.
probe_status: ok
Seen to answer. The strongest signal available.
probe_status: null
Never probed. Permitted but unproven, so pin with a fallback.
not_entitled_reason
Why we refused, in a machine-readable code.
# Permitted, and never probed. Both facts are true at once.
{ "id": "glm-4.6", "entitled": true, "probe_status": null }Two ways to reach a plan, and how much room is left
A completion subscription is one you call through us. A lease subscription is one you borrow, where your own runtime calls the provider and we are never in the completion path. Lease rows report the harness they inject into and how many accounts are free, so an orchestrator can size a parallel run instead of discovering the ceiling with a 409.
usage: completion
You post to /chat/completions and we reach the provider.
usage: lease
You borrow the credential. models[] is empty by design.
free_slots
A floor, never a reservation. Leases expire, so it can only rise.
total_slots
Accounts the lease would consider, not every vaulted row.