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. The account activity log requires activity:read and access to the requested account group.

Activity semantics

Future activity is provisional. Use executedAt with a final state to distinguish successful or failed execution from queued, scheduled, or waiting work.

Activity window

The default activity window covers seven days before and after the request time. Explicit from/to windows may cover at most 14 days and use cursor pagination.

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"
}