---
title: "Create decision"
method: POST
path: "/v0/legal-persons/{legal-person-id}/decisions"
tags: ["Decisions"]
---

# Create decision

`POST /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`

Creates a decision against the legal person.

The provided verification must have a `verification-status` of `checks-complete`, otherwise a 422 is served.

When a decision is successfully created, the legal person's `application-status` is updated accordingly.

Multiple decisions may be made against the same legal person.

## Path parameters

- `legal-person-id` string, required

## Request body

- object
  - `verification-url` string, required: A link to the [verification](#tag/Verifications).
  - `decision-outcome` 'accepted' | 'declined', required
  - `decision-notes` string, required: Free-text field to explain the reasons behind the decision.

## Response `201`

Created

- 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-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).

## Other responses

- `400`: Bad Request
- `401`: Requires an API key to continue
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-09-19** `3e69d9e24ef6`: 1 info
  - api operation id `post-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/post.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)