---
title: "List Organization Members"
method: GET
path: "/agency/{entityId}/subscription/members"
tags: ["Organization"]
---

# List Organization Members

`GET /agency/{entityId}/subscription/members`

## Request

- Base URL: `https://api.gigwell.com/api`
- URL: `https://api.gigwell.com/api/agency/{entityId}/subscription/members`
- Auth: HTTP bearer

Returns the members of the agency or talent-buyer organization identified by `entityId`, including each member's roles and status.

Each organization you belong to is identified by its own `entityId`. Call this endpoint with a specific `entityId` to list that organization's members, and repeat with a different `entityId` to inspect another of your memberships.

The `entityId` values returned here are the same identifiers you pass to [Run Report](./run-custom-filtered-export) to scope a report to a particular organization.

## Path parameters

- `entityId` string, required

## Response `200`

OK

- ListMembersResponse
  - `status` 'OK' | 'FAIL' | 'ERROR'
  - `code` string, nullable: ResultCode enum name (e.g. SUCCESS, NOT_FOUND, RATE_LIMIT_EXCEEDED)
  - `message` string, nullable: Result message: OK on success; the error text when status is FAIL or ERROR.
  - `messages` string[], nullable: In rare, specific cases, additional error messages.
  - `data` object
    - `members` object[]: The organization's members, one entry per member.
      - `account` Account
        - `id` string: Unique identifier of the member's Gigwell account.
        - `firstName` string: Member's first name.
        - `lastName` string: Member's last name.
        - `email` string: Member's email address, used as the account login and primary contact.
        - `displayTitle` string: Read-only display name for the member, composed from first and last name.
        - `avatarImageUrl` string: URL of the member's small avatar image; absent when no avatar is set.
        - `profileImageUrl` string: URL of the member's full-size profile image; absent when none is set.
        - `primaryPhone` PhoneNumber
          - `primary` boolean: Whether this is the primary phone number.
          - `type` string: Number type. Default main.
          - `number` string: The phone number.
        - `active` boolean: Whether the member's Gigwell account is active.
      - `membershipEntry` object: The member's membership record within the queried organization — roles, active state, and membership title; scoped to this organization only, not the account's memberships elsewhere.
        - `identityId` string
        - `roles` string[]: The member's roles within this organization.
        - `active` boolean
        - `title` string
  - `requestId` string, nullable: A request correlation id generated by the server.

## Changes

- **2026-10-30** `f761a02f0202`: 1 breaking, 9 warning, 1 info
  - the `data/members/items/account` response's property type changed from `object` to no type for status `200`
  - removed the optional property `data/members/items/account/active` from the response with the `200` status
  - removed the optional property `data/members/items/account/avatarImageUrl` from the response with the `200` status
  - removed the optional property `data/members/items/account/displayTitle` from the response with the `200` status
  - …7 more

[Operation history](https://skmtc.dev/gigwell/apis/gigwell-public-api/changes/agency/:entityId/subscription/members/get.md)

---

[API](https://skmtc.dev/gigwell/apis/gigwell-public-api.md) - [All operations](https://skmtc.dev/gigwell/apis/gigwell-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gigwell/apis/gigwell-public-api/revisions/0e75f0ca0803?raw)