---
title: "Approve or deny a transaction"
method: PUT
path: "/transactions/{uid}/authorize"
tags: ["Transactions"]
---

# Approve or deny a transaction

`PUT /transactions/{uid}/authorize`

Approves or denies a pending Transaction. This endpoint is used to explicitly authorize or reject a Transaction before it is executed.

## Request body

- object
  - `authorization_status` 'client_approved' | 'client_denied', required — The current status of the transaction authorization.
  - `denied_memo` string — Freeform text (up to 44 characters) that should be attached to the transaction if the transaction is to be denied. Optional.
  - `denied_reason` 'debit_limit_exceeded' | 'insufficient_funds' | 'international_payment' | 'unauthorized_credit' | 'unauthorized_debit' | 'vrn_archived' | 'vrn_locked' — The reason for the authorization denial. For wire transactions, must be one of (`vrn_archived`), (`vrn_locked`), (`international_payment`), (`unauthorized_credit`). For ACH transactions, must be one of (`vrn_archived`), (`vrn_locked`), (`debit_limit_exceeded`), (`unauthorized_credit`), (`unauthorized_debit`), (`insufficient_funds`)

## Response `200`

The authorization resource is returned

- object
  - `authorization` object — Transaction Authorization information. Only present if authorization was required for a given transaction.
    - `authorization_finalized_at` string, date-time — The date and time when authorization for this transaction got finalized. It will only appear if authorization status is in one of the final statuses: `auto_approved`, `auto_denied`, `client_approved`, `client_denied`, `client_unanswered_auto_approved` or `client_unanswered_auto_denied`.
    - `authorization_required_by` string, date-time — The date and time representing the deadline by which the authorization decision should be made by client. If no authorization is provided by this date, the transaction status will transition to client_unanswered_auto_approved.
    - `authorization_status` 'auto_approved' | 'auto_denied' | 'client_approval_pending' | 'client_approved' | 'client_denied' | 'client_unanswered_auto_approved' | 'client_unanswered_auto_denied' | 'created' — A value indicating the current state of authorization for this transaction.
    - `denied_memo` string — Freeform text (up to 44 characters) attached as a memo to authorization. It will only appear if authorization status is `auto_denied`, `client_denied` or `client_unanswered_auto_denied`.
    - `denied_reason` string — A description of why the authorization was denied. It will only appear if authorization status is `auto_denied`, `client_denied` or `client_unanswered_auto_denied`.

## Other responses

- `400` — Bad authorization request
- `403` — Client authorization disabled. (The Program is not configured for Client Authorization)
- `422` — An exception occurred while authorizing transaction

---

[API](https://skmtc.net/newline53/apis/newline-platform-api.md) · [All operations](https://skmtc.net/newline53/apis/newline-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/newline53/newline-platform-api/versions/5fcc8eb15061/schema)