---
title: "List Cross-border Requests"
method: GET
path: "/api/b2b/cross-border/requests"
tags: ["Cross-border Requests"]
---

# List Cross-border Requests

`GET /api/b2b/cross-border/requests`

## Request

- Base URL: `https://api-v2.honeycoin.app`
- URL: `https://api-v2.honeycoin.app/api/b2b/cross-border/requests`
- Auth: API key in header `Authorization`

List your requests, newest first. Filter by request status or senderId. Results are in data and pagination is at the top level. There is no externalReference query filter on this endpoint. Sandbox: use the same suffix under /api/sandbox/b2b/cross-border/requests with a sandbox bearer token.

## Query parameters

- `status` 'documents_required' | 'documents_submitted' | 'documents_rejected' | 'documents_approved' | 'pending_charge' | 'charge_initiated' | 'charge_successful' | 'charge_failed' | 'payout_initiated' | 'payout_successful' | 'payout_failed' | 'refund_inititated' | 'refund_successful' | 'refund_failed' | 'closed': Request lifecycle status. The refund-in-progress wire value is spelled refund_inititated.
- `senderId` string
- `limit` integer
- `after` string
- `before` string

## Response `200`

Successful response.

- object
  - `success` true, required
  - `data` CrossBorderRequest[], required
    - `id` string, required: Cross-border request ID, distinct from a charge transaction ID.
    - `senderId` string
    - `purpose` 'salary' | 'service_payment' | 'goods_payment' | 'family_support'
    - `subPurpose` string, nullable: Payment sub-purpose. Required on new requests; older records may contain null.
    - `externalReference` string
    - `requestType` string
    - `status` 'documents_required' | 'documents_submitted' | 'documents_rejected' | 'documents_approved' | 'pending_charge' | 'charge_initiated' | 'charge_successful' | 'charge_failed' | 'payout_initiated' | 'payout_successful' | 'payout_failed' | 'refund_inititated' | 'refund_successful' | 'refund_failed' | 'closed', required: Request lifecycle status. The refund-in-progress wire value is spelled refund_inititated.
    - `quote` CrossBorderQuote, required: Quote used by the request's charge attempt. The returned receiverAmount is after the quoted fee; do not calculate it from the displayed exchange rate.
      - `id` string, required: Quote ID used to initiate the charge.
      - `senderAmount` number, required
      - `senderCurrency` string, required
      - `receiverAmount` number, required
      - `receiverCurrency` string, required
      - `exchangeRate` number, required
      - `expiresAt` integer, required: Quote expiry as a Unix timestamp in milliseconds. Expiry does not cancel an initiated charge.
    - `chargeDetails` object: Saved collection details for the selected momo or bank method.
    - `senderCurrency` string
    - `receiverCurrency` string
    - `createdAt` integer: Unix milliseconds.
    - `updatedAt` integer: Unix milliseconds.
    - `beneficiaryId` string, required: An active saved beneficiary belonging to your account in this environment.
    - `requiredDocuments` CrossBorderDocumentRequirement[]: Every group is required; one alternative within each anyOf is sufficient. Empty means no documents required.
      - `anyOf` CrossBorderRequiredDocument[], required: At least one of these document types satisfies this group.
        - `type` 'proforma_invoice' | 'contract', required
        - `name` string, required
        - `description` string, required
    - `documents` CrossBorderDocument[]
      - `type` 'proforma_invoice' | 'contract', required
      - `fileId` string, required
      - `uploadedAt` integer, required: Unix milliseconds.
    - `rejectionReason` string: Review reason; interpret as current only in documents_rejected.
    - `senderAmount` number: Source amount supplied as amount on creation. Match it when obtaining a quote.
  - `pagination` CrossBorderPagination, required
    - `nextCursor` string, nullable, required
    - `prevCursor` string, nullable, required
    - `hasNext` boolean, required
    - `hasPrev` boolean, required
    - `limit` integer, required

## Other responses

- `400`: Invalid request, bearer token, or current request state.

## Changes

- **2026-11-03** `fcb58b0ef441`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/changes/api/b2b/cross-border/requests/get.md)

---

[API](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official.md) - [All operations](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/llms.txt) - [OpenAPI document](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/revisions/fcb58b0ef441?raw)