Throttling Tier (Individual)


Get details of a tier

GET https://apis.wso2.com/api/am/store/v0.13/tiers/{tierLevel}/{tierName}

This operation can be used to retrieve details of a single tier by specifying the tier level and tier name. `X-WSO2-Tenant` header can be used to retrive tiers that belongs to a different tenant domain. If not specified super tenant will be used. If Authorization header is present in the request, the user's tenant associated with the access token will be used.

OAuth 2.0 Scope

Not required

Request

GET https://localhost:9443/api/am/store/v0.13/tiers/api/Bronze

Response

HTTP/1.1 200 OK Content-Type: application/json { "unitTime": 60000, "tierPlan": "FREE", "stopOnQuotaReach": true, "tierLevel": "api", "requestCount": 1, "description": "Allows 1 request(s) per minute.", "name": "Bronze", "attributes": {} }

Sample CURL

curl "https://localhost:9443/api/am/store/v0.13/tiers/api/Bronze"

Sample CURL - for tenant

curl -k -H "X-WSO2-Tenant:test.com" https://localhost:9443/api/am/store/v0.13/tiers/api/Bronze

Parameters

Type Name Description Schema Default
Path

tierName

required

Tier name

String

Path

tierLevel

required

List API or Application type tiers.

Accepted values:

api application
String

Header

X-WSO2-Tenant

optional

For cross-tenant invocations, this is used to specify the tenant domain, where the resource need to be retirieved from.

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.

String

Header

If-Modified-Since

optional

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

String

Responses

HTTP Code Description Schema

200

OK. Tier returned

Tier

304

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

404

Not Found. Requested Tier does not exist.

Error

406

Not Acceptable. The requested media type is not supported.

Error