Retrieve Account List Folders

Retrieves the Account List Folders owned by the Organization of the caller.

Request
Security:
bearerAuth
query Parameters
pageToken
string

A page token, received from a previous call. Provide this token to retrieve the subsequent page.

To retrieve the first page, supply an empty page token.

When paginating, other parameters provided to the call must match the call that provided the page token.

Note: If a nextPageToken is returned by the endpoint, there may be more results regardless of whether or not the folders array is empty. Users must call this API with the returned nextPageToken until an empty nextPageToken is returned if they want to ensure that they have received all results.

pageSize
integer <int32>

The maximum size of the page results to return. Defaults to 100, max is 100.

Responses
200

A successful response.

400

Returned when bad request is received.

401

Returned when a request is made without a valid API key

403

Returned when the given user does not have permissions on the requested resource

404

Returned when the given resource is not found

429

Returned when the given user has reached their API rate limits.

500

Returned when there is an unrecoverable error in the API. If you continue to receive this error, please contact support and include your terminus-request-id.

503

Returned when the service is currently unavailable.

get/accountLists/v2/folders
Request samples
curl -i -X GET \
  'https://api.terminusplatform.com/accountLists/v2/folders?pageToken=string&pageSize=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
Response samples
    3 more
    429
    500
    503
application/json
{
  • "folders": [
    • {
      • "uuid": "string",
      • "name": "string",
      • "orgUuid": "string",
      • "folderAccess": "FOLDER_ACCESS_UNSPECIFIED",
      • "createdMomentUtc": "2019-08-24T14:15:22Z"
      }
    ],
  • "nextPageToken": "string"
}