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

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

---

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