# List Pay-In Instructions

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

The user's pay-in instructions, newest first.

## Overview

- `status`: `open` (waiting for the payment), `matched` (paid), `expired` (`payBy` passed) or `cancelled`.

Called with the user's access token, in one environment (`isTestnet`). See [Bank Ramp: Local Rails](https://docs.aureahub.com/docs/guide-bank-local.md).

## Endpoint

### `GET /v1/ramp/bank/customer/instructions`

Authentication: bearer token required.

The user's pay-in instructions, newest first.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | `true` for the sandbox; `false` or omitted for production |
| `limit` | integer | no | 1 to 100, default 20 |
| `offset` | integer | no | From 0, default 0 |

**Responses**

`200` Instructions

```json
{
  "environment": "production",
  "instructions": [
    {
      "id": "6b1f2d9e-3c4a-4e8b-9f21-7a5d0c3e8b14",
      "environment": "production",
      "asset": "KES",
      "requestedAmount": "15000.00",
      "amountToPay": "15000.37",
      "expectedCredit": "14775.36",
      "status": "open",
      "delivery": {
        "kind": "balance"
      },
      "payTo": {
        "asset": "KES",
        "rail": null,
        "institution": "Example Bank",
        "accountName": "Your Company Ltd",
        "accountNumber": "0123456789",
        "paybillNumber": "444174",
        "routingNumber": null,
        "bankCode": null,
        "bankAddress": null
      },
      "payBy": "2026-10-24T09:00:00.000Z",
      "matchedAt": null,
      "createdAt": "2026-10-23T09:00:00.000Z"
    }
  ],
  "limit": 20,
  "offset": 0
}
```

`403` No tenant

```json
{
  "statusCode": 403,
  "error": "ForbiddenError",
  "message": "This request needs a tenant: an admin token without one has no bank ramp customer.",
  "details": {
    "code": "TENANT_REQUIRED"
  }
}
```

---

Web version: https://docs.aureahub.com/#local-instructions