API Reference

List accounts accessible with this API key

GET/v1/accounts

Integration notes

Permissions

Any valid API key can list its accessible account groups; downstream endpoints require their section-specific scopes.

Idempotency

GET requests are read-only and do not use an Idempotency-Key header.

Parameters

This endpoint does not define parameters.

Request body

This endpoint does not define a request body.

Responses

200

List of accounts

Schema: AccountListSuccessResponse

401

Invalid or missing API key

Schema: ErrorResponse

429

Rate limit exceeded

Schema: ErrorResponse

500

Internal server error

Schema: ErrorResponse

Response examples

200 Example JSONAccountListSuccessResponse

{
    "success": true,
    "data": {
        "items": [
            {
                "id": "507f1f77bcf86cd799439011",
                "name": "Avery Stone",
                "createdAt": "2026-04-28T15:30:00.000Z"
            }
        ]
    },
    "error": null,
    "traceId": "507f1f77bcf86cd799439011"
}

401 Example JSONErrorResponse

{
    "success": false,
    "data": null,
    "error": {
        "code": "string",
        "message": "Thanks for the context. I can send over details this afternoon.",
        "details": "string"
    },
    "traceId": "507f1f77bcf86cd799439011"
}

429 Example JSONErrorResponse

{
    "success": false,
    "data": null,
    "error": {
        "code": "string",
        "message": "Thanks for the context. I can send over details this afternoon.",
        "details": "string"
    },
    "traceId": "507f1f77bcf86cd799439011"
}

500 Example JSONErrorResponse

{
    "success": false,
    "data": null,
    "error": {
        "code": "string",
        "message": "Thanks for the context. I can send over details this afternoon.",
        "details": "string"
    },
    "traceId": "507f1f77bcf86cd799439011"
}