GET
/
basins
curl --request GET \
  --url https://aws.s2.dev/v1/basins \
  --header 'Authorization: Bearer <token>'
{
  "basins": [
    {
      "name": "<string>",
      "scope": "aws:us-east-1",
      "state": "active"
    }
  ],
  "has_more": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
prefix
string
default:

List basin names that begin with this prefix.

​
start_after
string
default:

Only return basins names that lexicographically start after this name. This can be the last basin name seen in a previous listing, to continue from there. It must be greater than or equal to the prefix if specified.

​
limit
integer
default:1000

Number of results, up to a maximum of 1000.

Required range: 0 <= x <= 1000

Response

200
application/json
​
basins
object[]
required

Matching basins.

​
has_more
boolean
required

If set, indicates there are more results that can be listed with start_after.