> For the complete documentation index, see [llms.txt](https://docs.neox.vn/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neox.vn/docs/global/global-collections/integration/payout-requests.md).

# Payout Request APIs

**Payout Request APIs** provide a comprehensive set of endpoints for initiating, tracking, and reconciling outbound payments to registered beneficiaries — covering both same-currency domestic transfers and cross-currency international remittances.

By integrating with these APIs, organizations can:

* **Lock FX rates before sending:** Use the Payout Inquiry API to obtain a guaranteed exchange rate and fee estimate for cross-currency payouts, eliminating FX uncertainty before committing to a transfer.
* **Initiate payouts to beneficiaries:** Submit single or batch payout requests to domestic and overseas beneficiaries using flexible clearing options (SWIFT, LOCAL, AUTO) and purpose codes that satisfy regulatory reporting requirements.
* **Track payout outcomes in real time:** Poll [Get Detail Payout Request](/docs/global/global-collections/integration/payout-requests/get-detail-payout-request.md) at any time to retrieve the current status and details for any payout request, or rely on the `PAYMENT_INITIAL`/`PAYMENT_RESULT` webhooks for asynchronous notification.

In essence, **Payout Request APIs** empower you to manage the complete outbound payment lifecycle — from rate locking and payment initiation through to settlement confirmation.

{% hint style="warning" %}
The backend path for every endpoint in this section is **`/v2/gc/payment-requests`** — this doc section keeps the "Payout Request" terminology for consistency, but the URLs use `payment-requests`. Also: **Get List Distribution Records** is not available — see the notice on that page.
{% endhint %}

### Endpoints

| Method | Endpoint                                                                                                              | Description                                                  |
| ------ | --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| GET    | [Payout Inquiry](/docs/global/global-collections/integration/payout-requests/api-payout-inquiry.md)                   | Lock an FX rate/token for an upcoming cross-currency payout. |
| POST   | [Create Payout Request](/docs/global/global-collections/integration/payout-requests/api-create-payout-request.md)     | Initiate a payout to a registered beneficiary.               |
| GET    | [Get Detail Payout Request](/docs/global/global-collections/integration/payout-requests/get-detail-payout-request.md) | Retrieve full payout detail, or use its status-only variant. |