# Kong Routes API

**Canonical:** https://apis.io/apis/kong/kong-routes-api/  
**Provider:** Kong — https://apis.io/providers/kong/  
**Base URL:** https://konghq.com/  
**Documentation:** https://konghq.com/products/kong-gateway

Kong Routes API is one of 139 APIs that [Kong](https://apis.io/providers/kong/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Routes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, a GitHub repository, an API reference, authentication docs, and 1 JSON Schema.

Route entities define rules to match client requests. Each route is associated with a service, and a service may have multiple routes associated to it. Every request matching a given route will be proxied to the associated service. You need at least one matching rule that applies to the protocol being matched by the route. <br><br> The combination of routes and services, and the separation of concerns between them, offers a powerful routing mechanism with which it is possible to define fine-grained entrypoints in Kong Gateway leading to different upstream services of your infrastructure. <br><br> Depending on the protocol, one of the following attributes must be set: <br> - `http`: At least one of `methods`, `hosts`, `headers`, or `paths` - `https`: At least one of `methods`, `hosts`, `headers`, `paths`, or `snis` - `tcp`: At least one of `sources` or `destinations` - `tls`: at least one of `sources`, `destinations`, or `snis` - `tls_passthrough`: set `snis` - `grpc`: At least one of `hosts`, `headers`, or `paths` - `grpcs`: At least one of `hosts`, `headers`, `paths`, or `snis` - `ws`: At least one of `hosts`, `headers`, or `paths` - `wss`: At least one of `hosts`, `headers`, `paths`, or `snis` <br> A route can't have both `tls` and `tls_passthrough` protocols at same time. <br><br> Learn more about the router: - [Configure routes using expressions](https://developer.konghq.com/gateway/routing/expressions/)

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/kong/refs/heads/main/openapi/kong-routes-api-openapi.yml
- **Documentation** — https://developer.konghq.com/api/gateway/admin-ee/3.14/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/kong/refs/heads/main/json-schema/kong-service-schema.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/kong/refs/heads/main/json-ld/kong-context.jsonld
- **GitHubRepository** — https://github.com/Kong/kong
- **Documentation** — https://developer.konghq.com/api/
- **APIReference** — https://developer.konghq.com/api/
- **Authentication** — https://developer.konghq.com/konnect-platform/personal-access-tokens/
- **SDKs** — https://github.com/Kong/sdk-konnect-go
- **Documentation** — https://developer.konghq.com/event-gateway/

## Other Kong APIs (12)

- [Kong Gateway](https://apis.io/apis/kong/kong/)
- [Kong AI Gateway](https://apis.io/apis/kong/kong-ai-gateway/)
- [Kong Agent Gateway](https://apis.io/apis/kong/kong-agent-gateway/)
- [Kong MCP Registry](https://apis.io/apis/kong/kong-mcp-registry/)
- [Kong Context Mesh](https://apis.io/apis/kong/kong-context-mesh/)
- [Kong Mesh](https://apis.io/apis/kong/kong-mesh/)
- [Kong Insomnia](https://apis.io/apis/kong/kong-insomnia/)
- [Kong ACLs API](https://apis.io/apis/kong/kong-acls-api/)
- [Kong Add-Ons API](https://apis.io/apis/kong/kong-add-ons-api/)
- [Kong API API](https://apis.io/apis/kong/kong-api-api/)
- [Kong API Attributes API](https://apis.io/apis/kong/kong-api-attributes-api/)
- [Kong API Documentation API](https://apis.io/apis/kong/kong-api-documentation-api/)

## Tags

Routes

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/kong/kong-routes-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/kong/.