> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rebelfi.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Simulate Off-Ramp Transaction

> POST /v1/ramp/org/simulate-offramp-transaction — Simulate an off-ramp transaction lifecycle (sandbox only)

<Note>
  **Endpoint:** `POST https://api.rebelfi.io/v1/ramp/org/simulate-offramp-transaction`
</Note>

<Warning>
  This endpoint is only available in the **sandbox** environment. It will return an error in production.
</Warning>

Simulate an off-ramp transaction lifecycle to test your integration. The simulation progresses the transaction through the specified scenario's status sequence.

### Request Body

| Field                | Type     | Required | Description                                                               |
| -------------------- | -------- | -------- | ------------------------------------------------------------------------- |
| `scenario`           | `string` | No       | Simulation scenario (default: `"success"` — options: `success`, `failed`) |
| `usd_amount`         | `number` | No       | Simulated USD amount (default: `50000`)                                   |
| `offramp_account_id` | `number` | No       | Off-ramp account ID to simulate against                                   |

### Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.rebelfi.io/v1/ramp/org/simulate-offramp-transaction" \
    -H "x-api-key: your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "scenario": "success",
      "usd_amount": 25000,
      "offramp_account_id": 1
    }'
  ```

  ```typescript SDK theme={null}
  const simulation = await client.ramp.simulateOfframpTransaction({
    scenario: 'success',
    usdAmount: 25000
  });
  ```
</CodeGroup>

### Example Response

```json theme={null}
{
  "success": true,
  "data": {
    "simulation_id": "sim_x1y2z3",
    "state": "accepted"
  }
}
```

### Response Fields

| Field                | Type      | Description                          |
| -------------------- | --------- | ------------------------------------ |
| `success`            | `boolean` | Whether the simulation was accepted  |
| `data.simulation_id` | `string`  | Unique identifier for the simulation |
| `data.state`         | `string`  | Simulation state (`accepted`)        |