---
title: "List AwsAccounts"
method: GET
path: "/aws-accounts"
tags: ["AwsAccounts"]
---

# List AwsAccounts

`GET /aws-accounts`

## Request

- Base URL: `https://api.ravion.com`
- URL: `https://api.ravion.com/aws-accounts`
- Auth: HTTP bearer

List the AWS account connections in your organization. Returns a paginated collection with cursor metadata for fetching additional pages.

## Query parameters

- `cursor` string, nullable
- `limit` integer, nullable

## Response `200`

The request has succeeded.

- object
  - `data` AwsAccount[], required
    - `awsArn` string: AWS IAM role ARN for cross-account access
    - `awsId` string: AWS account ID (12-digit number)
    - `cfnStackId` string: CloudFormation stack ARN (set by ravion-lambda; used to generate upgrade URLs)
    - `createdAt` string, date-time, required: UTC RFC3339 timestamp with a required Z suffix
    - `givenId` string, required: User-provided identifier pattern used by all givenId fields
    - `id` string, required
    - `latestRoleVersion` string: Latest available role policy version (from server-side registry)
    - `latestRoleVersionDescription` string: Description of the latest role policy version
    - `name` string, required: Name of the AWS account
    - `organizationId` string, required
    - `roleVersion` string: PolicyVersion of the deployed CloudFormation stack (set by ravion-lambda on Create/Update)
    - `status` 'AWAITING_CONNECTION' | 'CONNECTED' | 'DISCONNECTED' | 'ERROR_REMOVING' | 'REMOVING', required: Status of the AWS account connection
    - `updatedAt` string, date-time, required: UTC RFC3339 timestamp with a required Z suffix
  - `meta` PaginationMeta, required
    - `limit` integer, required
    - `nextCursor` string
    - `totalCount` integer

## Other responses

- `400`: The request is invalid or malformed.
- `401`: You are not authenticated
- `403`: You do not have permission to access this resource.
- `422`: Client error
- `500`: Server error

---

[API](https://skmtc.dev/ravion/apis/ravion.md) - [All operations](https://skmtc.dev/ravion/apis/ravion/llms.txt) - [OpenAPI document](https://skmtc.dev/ravion/apis/ravion/revisions/66e5732205a0?raw)