---
title: "List legal persons"
method: GET
path: "/v0/organizations/{organization-id}/legal-persons"
tags: ["Legal persons"]
---

# List legal persons

`GET /v0/organizations/{organization-id}/legal-persons`

Returns a paginated list of all legal persons for the given organization.

By default, results are sorted descending by `created-at` (newest first). To sort ascending by `created-at`, provide a `?sort=created-at` query parameter.

## Path parameters

- `organization-id` string, required

## Query parameters

- `sort` '-status-changed-at' | 'status-changed-at' | '-created-at' | 'created-at'
- `include` string[]
- `filter[legal-person-status][in][]` string[]
- `filter[application-status][eq]` 'referred' | 'errored' | 'declined' | 'submitted' | 'accepted'
- `filter[has][]` string[]
- `page[size]` integer
- `page[after]` string, byte
- `page[before]` string, byte

## Response `200`

OK

- object
  - `legal-persons` object[], required
    - `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 — The mutable display name for the Legal-Person
    - `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
  - `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.

## Other responses

- `401` — Requires an API key to continue
- `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/7da510b95492/schema)