---
title: "List decisions"
method: GET
path: "/v0/legal-persons/{legal-person-id}/decisions"
tags: ["Decisions"]
---

# List decisions

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

## Request

- Base URL: `https://api.griffin.com`
- URL: `https://api.griffin.com/v0/legal-persons/{legal-person-id}/decisions`
- Auth: API key in header `Authorization`

Lists all decisions for the given legal-person.

## Path parameters

- `legal-person-id` string, required

## Query parameters

- `sort` '-created-at' | 'created-at'
- `page[size]` integer
- `page[after]` string, byte
- `page[before]` string, byte

## Response `200`

OK

- object
  - `decisions` object[], required
    - `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).
  - `links` object, required
    - `prev` string, nullable, required
    - `next` string, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Requires an API key to continue

## Changes

- **2026-09-19** `3e69d9e24ef6`: 1 info
  - api operation id `get-legal-persons-legal-person-id-decisions` was added

[Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/legal-persons/:legal-person-id/decisions/get.md)

---

[API](https://skmtc.dev/griffin/apis/the-griffin-api.md) - [All operations](https://skmtc.dev/griffin/apis/the-griffin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/griffin/apis/the-griffin-api/revisions/9e4c303c70a5?raw)