Skip to main content
GET
/
accounts
List Accounts
curl --request GET \
  --url https://api.rolla.xyz/api/v1/external/accounts \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "message": "Accounts retrieved successfully",
  "data": {
    "accounts": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "Beta Logistics LLC",
        "email": "jsmith@example.com",
        "applicationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "currentStep": 1,
        "isComplete": true,
        "createdAt": "2023-11-07T05:31:56Z"
      }
    ],
    "page": 123,
    "pageSize": 123,
    "totalCount": 123,
    "totalPages": 123,
    "hasMore": true
  }
}
Lists every account owned by the same user as your API key’s business — including the account your API key belongs to — with each application’s status.

​
Example Request

curl -X GET "https://api.rolla.xyz/api/v1/external/accounts?page=1&pageSize=20" \
  -H "X-API-Key: your_api_key_here"

​
Example Response

{
  "success": true,
  "message": "Accounts retrieved successfully",
  "data": {
    "accounts": [
      {
        "id": "6adb1c69-f42c-493c-9f66-6e8cfd6d2c35",
        "name": "Acme Trading Ltd",
        "email": "owner@example.com",
        "entityType": "business",
        "applicationId": "4d4ad44f-8e72-4be8-83f6-1e6c69e77962",
        "applicationStatus": "approved",
        "currentStep": 6,
        "isComplete": true,
        "createdAt": "2026-06-12T23:28:05.373Z"
      },
      {
        "id": "b6075be0-f1d0-451f-a468-3e94563101d2",
        "name": "Jane Doe",
        "email": "owner@example.com",
        "entityType": "individual",
        "applicationId": "f436daf8-146b-4949-bf28-9b36440085a4",
        "applicationStatus": "submitted",
        "currentStep": 3,
        "isComplete": true,
        "createdAt": "2026-06-12T23:30:43.040Z"
      }
    ],
    "page": 1,
    "pageSize": 20,
    "totalCount": 2,
    "totalPages": 1,
    "hasMore": false
  }
}

​
Query Parameters

ParameterTypeRequiredDescription
pageintegerNoPage number (default 1)
pageSizeintegerNoResults per page (default 20, max 100)
entityTypestringNoFilter by business or individual
statusstringNoFilter by application status (draft, submitted, approved, rejected, changes_requested)

Authorizations

​
X-API-Key
string
header
required

Your Rolla API key

Query Parameters

​
page
integer
default:1
​
pageSize
integer
default:20
Required range: x <= 100
​
entityType
enum<string>
Available options:
business,
individual
​
status
enum<string>

Filter by application status

Available options:
draft,
submitted,
approved,
rejected,
changes_requested

Response

Accounts retrieved successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Accounts retrieved successfully"

​
data
object