Accounts

Use the accounts API operation to get a list of accounts available to the authenticated user.

Get accounts

GET /accounts
Accept: application/vnd.ticketing.v2+json

During ticket creation, an account ID is required. This endpoint can be used to fetch all accounts that the authenticated user has permissions to view or create tickets in.

Request parameters

This operation does not accept a request body.

Response parameters

The response has the following body parameters in the accounts list.

Name	Type	Description
name	String	The name of the account.
id	String	The ID of the account. Accounts are comprised of a type prefix and account ID, with the exception of cloud accounts such as Cloud: 12345 or Managed Hosting: dedicated:12345.
RCN	String	The Rackspace Customer Number of the account.
serviceLevel	String	The service level of the account, if applicable.
severities	List	The severities that the account is allowed to set during ticket creation.
type	Object	The type of the account.
type.id	String	The common identifier of the account product type.
type.name	String	The common name of the account product type.
permission	String	The permissions the user has on the account, contains either `admin` or `observer`.
tags	List	These tags will represent product offerings consumed by the account. For example, our Professional Services or Platform Intelligence services.
npsOptOut	Bool	This flag indicates if an account has opted out of our NPS survey while closing a ticket in the portal. This has no impact on integration functionality.

Response example

The following example shows the JSON response for the request:

{
    "accounts": [
        {
            "name": "Faws Account",
            "id": "faws:12345",
            "rcn": "RCN-000-000-000",
            "serviceLevel": "Aviator",
            "severities": [
                "Low",
                "Normal",
                "High",
                "Urgent"
            ],
            "type": {
                "id": "faws",
                "name": "AWS"
            },
            "permission": "admin",
            "tags": [
              "proserv"
            ],
            "npsOptOut": false
        },
        {
            "name": "Cloud Account",
            "id": "12345",
            "rcn": "RCN-000-000-000",
            "serviceLevel": "",
            "severities": [
                "Normal"
            ],
            "type": {
                "id": "cloud",
                "name": "Rackspace Cloud"
            },
            "permission": "observer",
            "tags": [],
            "npsOptOut": false
        }
    ]
}

Response codes

The following table shows the possible response codes for this operation:

Code	Name	Description
200	Success	The request succeeded.
429	Too Many Requests	The application has a built-in rate limit of 60 requests per minute. If you exceed this limit, you receive a 429 status code response until the cool off period has elapsed.