API (Collection)


Retrieve/Search APIs

GET https://apis.wso2.com/api/am/publisher/v0.13/apis

This operation provides you a list of available APIs qualifying under a given search condition. Each retrieved API is represented with a minimal amount of attributes. If you want to get complete details of an API, you need to use **Get details of an API** operation.

OAuth 2.0 Scope

apim:api_viewi

Request

GET https://localhost:9443/api/am/publisher/v0.13/apis Authorization: Bearer ae4eae22-3f65-387b-a171-d37eaa366fa8

Response

HTTP/1.1 200 OK Content-Type: application/json { "previous": "", "list": [ { "provider": "admin", "version": "1.0.0", "description": "This sample API provides Account Status Validation", "name": "AccountVal", "context": "/account", "id": "2e81f147-c8a8-4f68-b4f0-69e0e7510b01", "status": "PUBLISHED" }, { "provider": "admin", "version": "1.0.0", "description": null, "name": "api1", "context": "/api1", "id": "3e22d2fb-277a-4e9e-8c7e-1c0f7f73960e", "status": "PUBLISHED" } ], "next": "", "count": 2 }

Sample CURL

curl -k -H "Authorization: Bearer ae4eae22-3f65-387b-a171-d37eaa366fa8" https://localhost:9443/api/am/publisher/v0.13/apis

Parameters

Type Name Description Schema Default
Query

limit

optional

Maximum size of resource array to return.

Integer

25

Query

offset

optional

Starting point within the complete list of items qualified.

Integer

0

Query

query

optional

**Search condition**. You can search in attributes by using an **"<attribute>:"** modifier. Eg. "provider:wso2" will match an API if the provider of the API is exactly "wso2". Additionally you can use wildcards. Eg. "provider:wso2*" will match an API if the provider of the API starts with "wso2". Supported attribute modifiers are [**version, context, status, description, subcontext, doc, provider**] If no advanced attribute modifier has been specified, the API names containing the search term will be returned as a result.

String

Header

Accept

optional

Media types acceptable for the response. Default is application/json.

String

application/json

Header

If-None-Match

optional

Validator for conditional requests; based on the ETag of the formerly retrieved variant of the resource (Will be supported in future).

String

Query

expand

optional

Whether the returned response should contain full details of API

Boolean

Responses

HTTP Code Description Schema

200

OK. List of qualifying APIs is returned.

APIList

304

Not Modified. Empty body because the client has already the latest version of the requested resource (Will be supported in future).

406

Not Acceptable. The requested media type is not supported

Error