| Property | Value |
|---|---|
| Auth | Required |
| Required plan | Business or Enterprise |
| Idempotent | Yes |
Query
| Field | Type | Required | Notes |
|---|---|---|---|
accountId | string | no | Defaults to the caller’s account. Investor-tier callers may pass a portfolio account id they have an active credential grant for. |
Errors
| Status | Code | When |
|---|---|---|
| 401 | AUTH_REQUIRED | No session. |
| 403 | FEATURE_GATED | Caller is on Free or Pro. |
| 403 | FORBIDDEN | accountId not owned and no active credential grant. |
| 500 | INTERNAL_ERROR | Read failed. |