---
title: "GET /v0/legal-persons/{legal-person-id}/history"
method: GET
path: "/v0/legal-persons/{legal-person-id}/history"
tags: ["Legal person history"]
---

# GET /v0/legal-persons/{legal-person-id}/history

`GET /v0/legal-persons/{legal-person-id}/history`

Lists history of events for the given legal person.

## Path parameters

- `legal-person-id` string, required

## Query parameters

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

## Response `200`

OK

- object
  - `legal-person-history` union[], required
    - union
      - object
        - `legal-person-history-event-type` 'risk-rating-registered', required
        - `timestamp` string, date-time, required — Date time of this event.
        - `risk-rating` 'high-risk' | 'prohibited-risk' | 'medium-risk' | 'low-risk', required
        - `notes` string — Rationale for overriding the risk rating.
        - `manually-created-by` object — User that triggered this event.
          - `manually-created-by-type` 'ops-user', required
        - `previous-risk-rating` 'high-risk' | 'prohibited-risk' | 'medium-risk' | 'low-risk'
      - object
        - `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-history-event-type` 'risk-rating-registered' | 'decision-created' | 'verification-created', required
        - `timestamp` string, date-time, required — Date time of this event.
        - `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).
      - object
        - `legal-person-history-event-type` 'verification-created', required
        - `timestamp` string, date-time, required — Date time of this event.
        - `verification-url` string, required — A link to the [verification](#tag/Verifications).
        - `workflow-url` string, required — A link to the [workflow](/docs/terms/workflow).
  - `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

- `400` — Bad Request
- `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)