---
title: "Get a Cross-border Request"
method: GET
path: "/api/b2b/cross-border/requests/{id}"
tags: ["Cross-border Requests"]
---

# Get a Cross-border Request

`GET /api/b2b/cross-border/requests/{id}`

## Request

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

Fetch a request by its request ID. Read senderAmount, senderCurrency and receiverCurrency when obtaining a quote. quote is null on creation and contains the quote used once a charge attempt consumes it. Use beneficiaryId to fetch recipient identity and payout details separately. payout_successful confirms beneficiary payout; a successful source charge alone is not transfer completion. Sandbox uses the same suffix under /api/sandbox/b2b/cross-border/requests with a sandbox bearer token.

## Path parameters

- `id` string, required

## 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.

## 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/:id/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)