---
title: "List legal person in a pooled account membership"
method: GET
path: "/v0/bank/accounts/{bank-account-id}/membership"
tags: ["Pooled account membership"]
---

# List legal person in a pooled account membership

`GET /v0/bank/accounts/{bank-account-id}/membership`

List legal persons in a pooled account membership

## Path parameters

- `bank-account-id` string, required

## Query parameters

- `include` string[]
- `page[size]` integer
- `page[after]` string, byte
- `page[before]` string, byte

## Response `200`

OK

- object
  - `pool-members` object[], required
    - `created-at` string, date-time, required — ISO 8601 formatted date-time.
    - `legal-person-url` union, required — A contextual link to the [legal person](#tag/Legal-persons).
      - string
      - string
  - `links` object, required
    - `prev` string, nullable, required
    - `next` string, nullable, required
  - `meta` object
    - `page` object
      - `total` integer — Total number of items. Present when the total number of items in the full result set is less than 10,000.
      - `estimated-total` object
        - `at-least` 10000 — Present when the total number of items in the full result set exceeds 10,000. This indicates that the actual number of items is at least 10,000, but the exact total is not provided due to performance considerations.
  - `included` object — Present only when the request uses the `include` parameter.
    - `verifications` object[]
      - `verification-profiles-url` union — Get claims used in this [verification](#tag/Verifications) for all associated [legal persons](/docs/terms/legal-person).
        - string
        - string
      - `verification-url` string, required — A link to the [verification](#tag/Verifications).
      - `verification-resources-url` string — A link to the resources of a [verification](#tag/Verifications).
      - `updated-at` string, date-time — ISO 8601 formatted date-time.
      - `legal-person-url` union, required — A contextual link to the [legal person](#tag/Legal-persons).
        - string
        - string
      - `workflow-url` string — A link to the [workflow](/docs/terms/workflow).
      - `created-at` string, date-time, required — ISO 8601 formatted date-time.
      - `verification-checks-url` string, required
      - `risk-rating` 'high-risk' | 'prohibited-risk' | 'medium-risk' | 'low-risk'
      - `verification-status` 'in-progress' | 'pending' | 'checks-declined' | 'checks-complete' | 'failed', required
      - `verification-risk-assessments-url` string
    - `risk-rating-entries` object[]
      - `risk-rating-url` string, required — A contextual link to the risk rating.
      - `risk-rating` 'high-risk' | 'prohibited-risk' | 'medium-risk' | 'low-risk', required
      - `legal-person-url` union, required — A contextual link to the [legal person](#tag/Legal-persons).
        - string
        - string
      - `notes` string — Rationale for overriding the risk rating.
      - `manually-created-by` object — User that triggered this event.
        - `manually-created-by-type` 'ops-user', required
      - `verification-url` string — A link to the [verification](#tag/Verifications).
      - `previous-risk-rating` 'high-risk' | 'prohibited-risk' | 'medium-risk' | 'low-risk'
    - `legal-persons` object[]
      - `latest-decision` object — The most recent [decision](#tag/Decisions)
        - `decision-outcome` 'accepted' | 'declined', required
        - `decision-notes` string, required — Free-text field to explain the reasons behind the decision.
        - `verification-url` string, required — A link to the [verification](#tag/Verifications).
        - `legal-person-url` union, required — A contextual link to the [legal person](#tag/Legal-persons).
          - string
          - string
        - `created-at` string, date-time, required — ISO 8601 formatted date-time.
        - `decision-maker` 'system' | 'ops-user' | 'user', required — Indicates if the decision was automated or made by a human.
        - `decision-user-url` string — Link to the [user](#tag/Users) that made the decision (if applicable).
        - `decision-ops-user` 'griffin-ops-user' — Indicates that an Ops user has created the decision.
        - `decision-user-username` string — Username of the [user](#tag/Users) that made the decision (if applicable).
      - `legal-person-type` 'individual' | 'corporation', required — Specifies if the legal person is an `individual` or a `corporation`.
      - `latest-risk-rating-url` string — A contextual link to the risk rating.
      - `display-name` string, required — A human readable label for an entity
      - `application-status` 'referred' | 'errored' | 'declined' | 'submitted' | 'accepted' — Status of the current [application](/docs/terms/application)
      - `legal-person-status` 'restricted' | 'onboarding-declined' | 'onboarded' | 'verified' | 'onboarding' — Status of the [legal person](#tag/Legal-persons)
      - `legal-person-url` union, required — A contextual link to the [legal person](#tag/Legal-persons).
        - string
        - string
      - `legal-person-decisions-url` union, required — Link to [decisions](#tag/Decisions) for this [legal person](/docs/terms/legal-person).
        - string
        - string
      - `status-changed-at` string, date-time — ISO 8601 formatted date-time.
      - `created-at` string, date-time, required — ISO 8601 formatted date-time.
      - `legal-person-claims-url` union — Link to the [claims](#tag/Claims) for this [legal person](/docs/terms/legal-person).
        - string
        - string
      - `legal-person-bank-payees-url` union — Link to the [payees](#tag/Payees) for this [legal person](/docs/terms/legal-person).
        - string
        - string
      - `legal-person-verifications-url` union, required — Link to all [verifications](#tag/Verifications) run against this [legal person](/docs/terms/legal-person).
        - string
        - string
      - `legal-name` string — A read-only, human readable label derived from claims
      - `legal-person-documents-url` union, required — Link to all evidence documents associated with this [legal person](/docs/terms/legal-person).
        - string
        - string

## Other responses

- `401` — Requires an API key to continue
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/griffin/apis/the-griffin-api.md) · [All operations](https://skmtc.net/griffin/apis/the-griffin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griffin/the-griffin-api/revisions/e56cd4bb9677/schema)
