List all routes in a service

GET /apisix/admin/routes

List all routes in a service

List routes in a service through an APISIX Admin API compatible endpoint under /apisix/admin/. Use pagination and filters to inspect APISIX-compatible route entries. Required IAM Permission: Action gateway:GetPublishedService, Resource arn:api7:gateway:gatewaygroup/%s/service/%s

Parameters

• service_id (query, string, required): The unique identifier of the service.
• page (query, integer, optional): Page number of the listed resources. Used together with page_size. For example, when there are 13 resources in total, if the query parameters are page=1&page_size=10, the GET response will show the route total as 13 and display 10 resources in the first page. If the query parameters are page=2&page_size=10, the GET response will show the route total as 13 and display 3 resources in the second page.
• page_size (query, integer, optional): Number of resources listed per page. Used together with page. For example, when there are 13 resources in total, if the query parameters are page=1&page_size=10, the GET response will show the route total as 13 and display 10 resources in the first page. If the query parameters are page=2&page_size=10, the GET response will show the route total as 13 and display 3 resources in the second page.
• direction (query, string, optional): Order to list the resources by. The sorting index follows the configuration of order_by.
• order_by (query, string, optional): Index to order resources by.
• search (query, string, optional): Condition to search resources by.
• gateway_group_id (query, string, required): Gateway group ID. Optional when using the gateway group admin key to authenticate.
• with_publish_info (query, boolean, optional): If true, include publish information in the response, such as apisix_route_id, route_version_id, and service_version_id. The additional information is only useful for the Dashboard and not for API users.

Responses

• 200: Successfully retrieved the paginated list of routes.
• allOf variant 1
• list (array, optional): An array of resources.
• total (integer, optional): Total number of objects.
• allOf variant 2
• list (array, optional): The array of routes.
• allOf variant 1
• allOf variant 1
• list[].name (string, optional): The object name.
• list[].labels (object, optional): Key-value pairs of labels.
• list[].desc (string, optional): The object description.
• list[].methods (array, optional): The allowed HTTP methods to access the route. If empty, all HTTP methods are allowed.
• list[].vars (array, optional): Conditions in the format of APISIX expressions to match requests to routes. Case sensitive when matching a cookie name.
• list[].paths (array, optional): The URL path(s) (after the service's path_prefix) that the route will listen to. Each path should start with a /.
• list[].priority (integer, optional): Priority of the route. A higher value corresponds to a higher priority. If different Routes matches to the same URI, then the Route with the highest priority will be matched.
• list[].enable_websocket (boolean,null, optional): If true, enable Websocket proxying for the route.
• allOf variant 2
• list[].timeout (object, optional): Timeout settings for connecting to, sending, and receiving messages from the upstream, in seconds.
• list[].timeout.connect (number, optional): Connection timeout in seconds.
• list[].timeout.send (number, optional): Sending timeout in seconds.
• list[].timeout.read (number, optional): Receiving timeout in seconds.
• list[].plugins (object, optional): Key-value pairs of plugins and their configurations on the object.
• allOf variant 2
• list[].id (string, optional): The object ID.
• list[].service_id (string, optional): The service ID.
• list[].created_at (integer, optional): The object created timestamp.
• list[].updated_at (integer, optional): The object updated timestamp.
• 400: Bad Request — The request was malformed or contained invalid parameters. Check the error_msg field for details.
• value (object, optional): The specific resource.
• error_msg (string, optional): The error message.

cURL

curl -X GET '$API_BASE_URL/apisix/admin/routes'