Account

List account members

List every member of the account, cursor-paginated with limit (1-100, default 25) and starting_after or ending_before.

  • Each item exposes id, name, email, role, external_advisor, grants[] and a permissions block; only grants on tax IDs you read are published.
  • Requires an owner or admin credential holder (403 forbidden_action). Requires the members:read scope, which * does not cover: the API key must list it explicitly.
get/accounts/{account}/members

Request

  • Base URL: https://api.factuarea.com/v1
  • URL: https://api.factuarea.com/v1/accounts/{account}/members
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

accountstring uuid required

Public identifier (UUID v7) of your account. Get it from GET /v1/me (data.account.id).

Headers

Factuarea-Versionstring date
Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

AccountMemberListV1Resource

has_moreboolean required

true when more members exist beyond this page.

next_cursorstring nullable required

Opaque cursor for the next page, or null when has_more is false.

Example response

{
  "data": [
    {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b10",
      "name": "Marta Ibáñez",
      "email": "marta@acme.example",
      "grants": [
        {
          "company_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01"
        }
      ],
      "permissions": {
        "can_change_role": true,
        "assignable_roles": [
          "admin",
          "member"
        ],
        "can_remove": true,
        "can_edit_grants": true
      },
      "joined_at": "2026-03-02T10:00:00Z",
      "last_access_at": "2026-10-08T07:45:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.