---
title: "Reject a payout"
method: POST
path: "/v1/simulations/payouts/{id}/reject"
tags: ["Simulations"]
---

# Reject a payout

`POST /v1/simulations/payouts/{id}/reject`

## Request

- Base URL: `https://api.augustus.com`
- URL: `https://api.augustus.com/v1/simulations/payouts/{id}/reject`
- Auth: HTTP bearer

Submits a network rejection for an existing payout through the sandbox provider pipeline. This endpoint is unavailable in live production.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- RejectPayoutSimulationBodyDto
  - `reason` 'invalid_routing_number' | 'invalid_account_format', required: Reason the sandbox provider rejects the payout. Use `invalid_routing_number` for domestic rails and `invalid_account_format` for a SWIFT correspondent rejecting on the beneficiary details.

## Response `200`

The payout rejection simulation acknowledgement

- PayoutSimulationResourceDto
  - `type` 'payout_simulation', required: Resource type discriminator.
  - `payout_id` string, uuid, required: Payout whose lifecycle is being simulated.

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-08-21** `79d607871de9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/simulations/payouts/:id/reject/post.md)

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) - [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/augustus/apis/ivy-api/revisions/e87bdcac11cc?raw)