[Skip to main content](#__docusaurus_skipToContent_fallback)
[](https://api7.ai/)
ProductsSolutions[Customers](https://api7.ai/customers)
Pricing
Resources[Blog](https://api7.ai/blog)
[Login](https://console.api7.cloud)Get a DemoStart for Free
[](https://api7.ai/)
* Products
[API7 Gateway](https://api7.ai/enterprise)[- ](https://api7.ai/enterprise)
[API7 Gateway](https://api7.ai/enterprise)[- ](https://api7.ai/api7-enterprise-vs-apisix)
[Apache APISIX vs API7](https://api7.ai/api7-enterprise-vs-apisix)[- ](https://api7.ai/portal)
[API7 API Portal](https://api7.ai/portal)
[Apache APISIX](https://api7.ai/apisix)[- ](https://api7.ai/apisix)
[What's Apache APISIX?](https://api7.ai/apisix)[- ](https://api7.ai/blog/why-is-apache-apisix-the-best-api-gateway)
[Why Apache APISIX?](https://api7.ai/blog/why-is-apache-apisix-the-best-api-gateway)[- ](https://api7.ai/apache-apisix-enterprise-support)
[APISIX Commercial Support](https://api7.ai/apache-apisix-enterprise-support)
[AISIX AI Gateway](https://api7.ai/ai-gateway)[- ](https://api7.ai/ai-gateway)
[AISIX AI Gateway](https://api7.ai/ai-gateway)
* Solutions
[Developer](https://api7.ai/solutions/monolith-to-microservices)[- ](https://api7.ai/solutions/monolith-to-microservices)
[Monolith to Microservices](https://api7.ai/solutions/monolith-to-microservices)[- ](https://api7.ai/solutions/on-prem-to-hybrid-cloud)
[On-Prem to Hybrid Cloud](https://api7.ai/solutions/on-prem-to-hybrid-cloud)[- ](https://api7.ai/solutions/observability)
[Observability](https://api7.ai/solutions/observability)
[- ](https://api7.ai/solutions/vm-to-kubernetes)
[VM to Kubernetes](https://api7.ai/solutions/vm-to-kubernetes)[- ](https://api7.ai/solutions/zero-trust-security)
[Zero Trust Security](https://api7.ai/solutions/zero-trust-security)
[Industry](https://api7.ai/solutions/financial-services)[- ](https://api7.ai/solutions/financial-services)
[Financial Services](https://api7.ai/solutions/financial-services)[- ](https://api7.ai/solutions/iot)
[IoT and Automotive](https://api7.ai/solutions/iot)[- ](https://api7.ai/solutions/blockchain)
[Blockchain](https://api7.ai/solutions/blockchain)
[- ](https://api7.ai/solutions/manufacturing)
[Manufacturing](https://api7.ai/solutions/manufacturing)
* [Customers](https://api7.ai/customers)
* Pricing
[- ](https://api7.ai/pricing)
[API Gateway](https://api7.ai/pricing)[- ](https://api7.ai/ai-gateway/pricing)
[AI Gateway](https://api7.ai/ai-gateway/pricing)
* Resources
[Docs](https://docs.api7.ai/ai-gateway/.md)[- ](https://docs.api7.ai/ai-gateway/.md)
[AISIX Docs](https://docs.api7.ai/ai-gateway/.md)[- ](https://docs.api7.ai/api7-gateway)
[API7 Gateway](https://docs.api7.ai/api7-gateway)[- ](https://skills.sh/api7/agent-skills/a7)
[API7 AI Agent Skills](https://skills.sh/api7/agent-skills/a7)[- ](https://docs.api7.ai/apisix)
[Apache APISIX](https://docs.api7.ai/apisix)[- ](https://skills.sh/api7/agent-skills/a6)
[APISIX AI Agent Skills](https://skills.sh/api7/agent-skills/a6)
[Compare](https://api7.ai/apisix-vs-kong)[- ](https://api7.ai/apisix-vs-kong)
[Apache APISIX vs Kong](https://api7.ai/apisix-vs-kong)[- ](https://api7.ai/apisix-vs-nginx)
[Apache APISIX vs NGINX](https://api7.ai/apisix-vs-nginx)[- ](https://api7.ai/api-gateway-comparison)
[2026 Top API Gateway Comparison](https://api7.ai/api-gateway-comparison)[- ](https://api7.ai/ai-gateway-comparison)
[AI Gateway Comparison](https://api7.ai/ai-gateway-comparison)
[Learn](https://api7.ai/learning-center/openresty)[- ](https://api7.ai/learning-center/openresty)
[OpenResty (NGINX + Lua)](https://api7.ai/learning-center/openresty)[- ](https://api7.ai/learning-center/api-gateway-guide)
[API Gateway Guide](https://api7.ai/learning-center/api-gateway-guide)[- ](https://api7.ai/learning-center/ai-gateway-guide)
[AI Gateway Guide](https://api7.ai/learning-center/ai-gateway-guide)[- ](https://api7.ai/learning-center/api-infrastructure-guide)
[API Infrastructure Guide](https://api7.ai/learning-center/api-infrastructure-guide)
[Explore](https://api7.ai/demos)[- ](https://api7.ai/demos)
[Demo Hub](https://api7.ai/demos)[- ](https://docs.api7.ai/hub.md)
[Plugin Hub](https://docs.api7.ai/hub.md)[- ](https://api7.ai/category/usercase)
[Case Studies](https://api7.ai/category/usercase)
* [Blog](https://api7.ai/blog)
Get a DemoStart for Free
[](https://docs.api7.ai/)[Apache APISIX](https://docs.api7.ai/apisix/documentation.md)[API7 Gateway](https://docs.api7.ai/api7-gateway/overview.md)[Ingress Controller](https://docs.api7.ai/ingress-controller/documentation.md)[AISIX AI Gateway](https://docs.api7.ai/ai-gateway/.md)[Plugin Hub](https://docs.api7.ai/hub.md)
Search
Contract versionLatest release — 1.9.0 (/ai-gateway/reference/admin-api)
# AISIX OSS Admin API
Optional operational API for inspecting a directly operated open-source AISIX gateway. Its read-only resource operations list loaded models, caller API keys, provider credentials, guardrails, MCP...
## Health
* [`GET` Get Gateway Health `/admin/v1/health`](#fallback-operation-0-0)
Get model health levels and configuration-watch freshness for this gateway.
* [`GET` Get Liveness Status `/livez`](#fallback-operation-0-1)
Process liveness: should this instance be restarted? Answers 200 whenever it answers at all, including throughout a graceful drain — draining is deliberate work, and restarting an instance that is finishing the requests it accepted would kill exactly those. Use /readyz for...
* [`GET` Get Readiness Status `/readyz`](#fallback-operation-0-2)
Traffic eligibility (readiness): 200 when the instance can serve, 503 while draining or before the first config apply. Stays 200 for as long as the instance keeps serving that configuration, however long ago the last config event was — see /admin/v1/health and /status/config...
## OpenAPI
* [`GET` Open Scalar UI `/admin/openapi-scalar`](#fallback-operation-1-0)
Open the browser UI that loads /admin/openapi.json from the admin listener.
* [`GET` Get OpenAPI Document `/admin/openapi.json`](#fallback-operation-1-1)
Get the machine-readable OpenAPI 3.1 document served by this gateway process.
## Models
* [`GET` List Models `/admin/v1/models`](#fallback-operation-2-0)
List all configured model resources.
* [`GET` List Model Runtime Status `/admin/v1/models/status`](#fallback-operation-2-1)
Returns runtime routing and exclusion state for every model.
* [`GET` Get Model by ID `/admin/v1/models/{id}`](#fallback-operation-2-2)
Get a model resource by ID.
## Caller API Keys
* [`GET` List Caller API Keys `/admin/v1/api_keys`](#fallback-operation-3-0)
List caller API keys with plaintext credentials redacted.
* [`GET` Get Caller API Key by ID `/admin/v1/api_keys/{id}`](#fallback-operation-3-1)
Get a caller API key by ID with plaintext credentials redacted.
* [`GET` List Caller API Keys (alternate path) `/admin/v1/apikeys`](#fallback-operation-3-2)
Alternate spelling of /admin/v1/api keys. Requests and responses are identical on both paths. List caller API keys with plaintext credentials redacted.
* [`GET` Get Caller API Key by ID (alternate path) `/admin/v1/apikeys/{id}`](#fallback-operation-3-3)
Alternate spelling of /admin/v1/api keys/{id}. Requests and responses are identical on both paths. Get a caller API key by ID with plaintext credentials redacted.
## Provider Keys
* [`GET` List Provider Keys `/admin/v1/provider_keys`](#fallback-operation-4-0)
List all configured provider key resources.
* [`GET` Get Provider Key by ID `/admin/v1/provider_keys/{id}`](#fallback-operation-4-1)
Get a provider key resource by ID.
## MCP Servers
* [`GET` List MCP Servers `/admin/v1/mcp_servers`](#fallback-operation-5-0)
List registered upstream MCP server resources.
* [`GET` Get MCP Server by ID `/admin/v1/mcp_servers/{id}`](#fallback-operation-5-1)
Get an upstream MCP server resource by ID.
## A2A Agents
* [`GET` List A2A Agents `/admin/v1/a2a_agents`](#fallback-operation-6-0)
List registered upstream A2A agent resources.
* [`GET` Get A2A Agent by ID `/admin/v1/a2a_agents/{id}`](#fallback-operation-6-1)
Get an upstream A2A agent resource by ID.
## Passthrough Routes
* [`GET` List Passthrough Routes `/admin/v1/passthrough_routes`](#fallback-operation-7-0)
List explicit passthrough route resources.
* [`GET` Get Passthrough Route by ID `/admin/v1/passthrough_routes/{id}`](#fallback-operation-7-1)
Get an explicit passthrough route resource by ID.
## Guardrails
* [`GET` List Guardrails `/admin/v1/guardrails`](#fallback-operation-8-0)
List all configured guardrail resources.
* [`GET` Get Guardrail by ID `/admin/v1/guardrails/{id}`](#fallback-operation-8-1)
Get a guardrail resource by ID.
## Cache Policies
* [`GET` List Cache Policies `/admin/v1/cache_policies`](#fallback-operation-9-0)
List all configured cache policy resources.
* [`GET` Get Cache Policy by ID `/admin/v1/cache_policies/{id}`](#fallback-operation-9-1)
Get a cache policy resource by ID.
## Observability Exporters
* [`GET` List Observability Exporters `/admin/v1/observability_exporters`](#fallback-operation-10-0)
List all configured observability exporter resources.
* [`GET` Get Observability Exporter by ID `/admin/v1/observability_exporters/{id}`](#fallback-operation-10-1)
Get an observability exporter resource by ID.
## Playground
* [`POST` Create Playground Chat Completion `/playground/chat/completions`](#fallback-operation-11-0)
Forwards a chat completion through the proxy path for local playground testing. Use a proxy API key, not an admin key.
The digital world is connected by APIs,
API7.ai exists to make APIs more efficient, reliable, and secure.
Sign up for API7 newsletter
[Email address]()Subscribe
Product
[API7 Gateway](https://api7.ai/enterprise)[AISIX AI Gateway](https://api7.ai/ai-gateway)[API7 API Portal](https://api7.ai/portal)
Learn
[API Gateway Guide](https://api7.ai/learning-center/api-gateway-guide)[Plugin Hub](https://docs.api7.ai/hub.md)[API Gateway Comparison](https://api7.ai/api-gateway-comparison)[Customers](https://api7.ai/customers)
Resources
[API Gateway Docs](https://docs.api7.ai/apisix/documentation.md)[APISIX AI Agent Skills](https://skills.sh/api7/agent-skills/a6)[API7 AI Agent Skills](https://skills.sh/api7/agent-skills/a7)[Blog](https://api7.ai/blog)[Demo Hub](https://api7.ai/demos)[APISIX vs Kong](https://api7.ai/apisix-vs-kong)[AI Gateway Comparison](https://api7.ai/ai-gateway-comparison)
Company
[About](https://api7.ai/about)[Contact](https://api7.ai/contact)[Partners](https://api7.ai/partners)[Compliance Standards](https://api7.ai/trust)[Brand Assets](https://api7.ai/branding)[Terms & Privacy](https://api7.ai/terms)
***
[](https://api7.ai/compliance)
[](https://api7.ai/compliance)
[](https://api7.ai/compliance)
[](https://api7.ai/compliance)
[](https://api7.ai/blog/among-2022-red-herring-top-100-global)
Copyright © APISEVEN PTE. LTD 2019 – 2026. Apache, Apache APISIX, APISIX, and associated open source project names are trademarks of the [Apache Software Foundation](https://www.apache.org/)
[](https://www.linkedin.com/company/api7-ai/)[](https://github.com/api7)[](https://twitter.com/api7_ai)