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

# List Cross-border Senders

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

## Request

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

List active senders, newest first. The records and pagination are both nested inside data. Sandbox: use the same suffix under /api/sandbox/b2b/cross-border/requests with a sandbox bearer token.

## Query parameters

- `limit` integer
- `after` string
- `before` string

## Response `200`

Successful response.

- object
  - `success` true, required
  - `data` object, required
    - `senders` CrossBorderSender[], required
      - `phoneNumber` string: International phone number including + and country calling code.
      - `email` string, email, required: Unique among active senders in your account; normalized to lowercase.
      - `idType` 'passport' | 'national-id' | 'business-registration-number'
      - `idCountry` string: Two-letter country code, uppercase.
      - `idNumber` string: Personal identity document number for an individual sender.
      - `nationality` string, nullable
      - `address` object
        - `country` string, required: Two-letter country code, uppercase.
        - `city` string, required: City; normalized to uppercase.
        - `street1` string, required
        - `street2` string, nullable
        - `postalCode` string, required
      - `type` 'individual' | 'business', required
      - `firstName` string: Letters, spaces, apostrophes and hyphens.
      - `lastName` string: Letters, spaces, apostrophes and hyphens.
      - `birthday` string: Date of birth in YYYY-MM-DD format.
      - `companyName` string: Registered business name.
      - `id` string, required: Save this ID as senderId when creating requests.
      - `createdAt` integer: Unix timestamp in milliseconds.
      - `updatedAt` integer: Unix timestamp in milliseconds.
      - `registrationNumber` string: Business registration number for a business sender.
    - `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/senders/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)