List versions

get

https://{hostname}/api-definitions/v2/endpoints/{apiEndPointId}/versions

Returns versions of an endpoint, with results optionally paginated, sorted, and filtered.

Path Params

apiEndPointId

integer

required

The unique identifier for the endpoint.

Query Params

page

integer

Defaults to 1

The page number index, starting at the default value of 1.

pageSize

integer

Defaults to 2147483647

The number of endpoint versions on each page of results.

sortBy

string

enum

Defaults to versionNumber

Enum The field to sort endpoint versions by, versionNumber by default.

Allowed:

sortOrder

string

enum

Defaults to desc

Enum The sort order, either asc for ascending or the default desc for descending.

Allowed:

show

string

enum

Defaults to ALL

Enum The type of endpoint versions to return based on their visibility status. By default the API returns ALL endpoint version. You can instead decide to return ONLY_VISIBLE endpoint versions, or ONLY_HIDDEN endpoint versions. Run the Show a version and Hide a version operations to control which endpoint versions are listed.

Allowed:

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

URL

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Lists API endpoint versions you have access to in this account.

403Forbidden. You don't have permission to retrieve the API endpoint versions list.