---
title: "Create a limit reduction notice"
method: POST
path: "/facilities/{facility_id}/create_limit_reduction_notice"
tags: ["Facilities"]
---

# Create a limit reduction notice

`POST /facilities/{facility_id}/create_limit_reduction_notice`

## Request

- Base URL: `https://production.pier-finance.com/api`
- URL: `https://production.pier-finance.com/api/facilities/{facility_id}/create_limit_reduction_notice`
- Auth: HTTP bearer

Create a limit reduction notice, which should be presented to the user when their credit limit is reduced. This endpoint must be called before reducing the credit limit. The document_id returned should be stored and used in the PATCH /facilities/{facility_id}/update_limit endpoint.

## Path parameters

- `facility_id` string, required

## Request body

- object
  - `new_limit_amount` integer, required: Amount of the new credit limit, in cents
  - `reasons` LimitReductionReasons[], required: The reasons for the limit reduction

## Response `200`

- Document
  - `document_url` string, required: The URL where the document can be accessed.
  - `id` string, required: The unique identifier for the document.

## Other responses

- `400`
- `401`
- `404`
- `429`
- `500`

---

[API](https://skmtc.dev/pier-finance/apis/pier-api.md) - [All operations](https://skmtc.dev/pier-finance/apis/pier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pier-finance/apis/pier-api/revisions/08a7c49252b9?raw)