BucktDocs

Get AWS account

GET/v1/aws-accounts/{id}aws-accounts:readSDK: awsAccounts.get

Returns the connected AWS account record, including the externalId you need to use as the IAM role's trust condition. The awsAccountId field shows a placeholder until validation succeeds and Buckt confirms the real 12-digit AWS account number.

Path parameters

NameTypeDefaultDescription
idrequiredstring—Buckt's AWS account record ID (not your AWS account number).

Example request

import { Buckt } from "@buckt/sdk";

const client = new Buckt({ apiKey: process.env.BUCKT_API_KEY });

const account = await client.awsAccounts.get(
  "acc_01J5AAAAAAAAAAAAAAAAAAAAAA"
);

Responses

{
  "data": {
    "object": "aws_account",
    "id": "acc_01J5AAAAAAAAAAAAAAAAAAAAAA",
    "awsAccountId": "123456789012",
    "externalId": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
    "roleArn": "arn:aws:iam::123456789012:role/BucktAccess",
    "stackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/buckt-byoa/abc123",
    "label": "Production AWS",
    "status": "active",
    "lastValidatedAt": "2026-04-25T11:30:00Z",
    "createdAt": "2026-04-20T10:00:00Z",
    "updatedAt": "2026-04-25T11:30:00Z"
  },
  "error": null,
  "meta": null
}