# List payment reasons

**GET /api/v1/payment-reasons**

Returns configured payment reasons. Put the selected id in paymentReasons.paymentReasonId when creating a beneficiary withdrawal. requiredTextFields describes the additional flat paymentReasons fields; requiredUploadFile describes required documents and their allowedFileTypes.


## Servers
- https://api.staging.lumetrade.com: https://api.staging.lumetrade.com ()



## Parameters




## Responses
### 200
Payment reasons returned successfully

#### Body: application/json (array[object])
- **id** (integer(int64))
  Payment reason id to submit as paymentReasonId.

- **reason** (string)
  Consumer-facing payment reason.

- **requiredTextFields** (object)
  Text inputs required in paymentReasonTextValues, keyed by input name.

- **requiredUploadFile** (object)
  Required upload inputs keyed by document name, including allowedFileTypes metadata.


### 429
Cloudflare API rate limit exceeded

#### Body: application/json (object)
- **error** (string)

- **message** (string)


### 400
Request validation failed

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 500
Unexpected server error

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])



[Powered by Bump.sh](https://bump.sh)