---
title: "GET /api/customers/transfers"
method: GET
path: "/api/customers/transfers"
tags: ["api", "transfers"]
---

# GET /api/customers/transfers

`GET /api/customers/transfers`

Get All Transfers

## Query parameters

- `top` integer, required — A limit on the number of objects to be returned. Can range between 1 and 1000.
- `skip` integer, required — The number of objects to skip for the requested result
- `createdAt` object
  - `$gt` string, date-time — value is greater than
  - `$gte` string, date-time — value is greater than or equal
  - `$lt` string, date-time — value is less than
  - `$lte` string, date-time — value is less than or equal
  - `$eq` string, date-time — value is equal
  - `$ne` string, date-time — value is not equal
- `updatedAt` object
  - `$gt` string, date-time — value is greater than
  - `$gte` string, date-time — value is greater than or equal
  - `$lt` string, date-time — value is less than
  - `$lte` string, date-time — value is less than or equal
  - `$eq` string, date-time — value is equal
  - `$ne` string, date-time — value is not equal
- `status` union
  - 'PENDING' | 'PROCESSING' | 'SUCCEEDED' | 'FAILED'
  - string[]
- `references` unknown[] — The IDs or references of the transfers
  - unknown
- `customerId` string

## Response `200`

OK

- object
  - `docs` object[], required
    - `_id` string, required
    - `sellerId` string, required
    - `customerId` string, required
    - `reference` string
    - `amount` number, required
    - `currency` 'EUR' | 'USD' | 'GBP' | 'AUD' | 'CHF' | 'THB' | 'ILS' | 'COP' | 'MXN' | 'DKK' | 'NOK' | 'SEK' | 'QAR' | 'CAD' | 'ISK' | 'GTQ' | 'INR' | 'DOP' | 'SGD' | 'PLN' | 'SAR' | 'TTD' | 'ZAR' | 'KYD' | 'HKD' | 'CZK' | 'KRW' | 'JPY' | 'NZD' | 'AED' | 'MAD' | 'TWD' | 'BRL' | 'BWP' | 'NAD' | 'KES' | 'SCR' | 'TRY' | 'SZL' | 'LSL' | 'TZS' | 'UGX' | 'ZMW' | 'ZWG' | 'GHS' | 'NGN' | 'SLE' | 'LRD' | 'XOF' | 'XAF' | 'GEL' | 'IDR' | 'ARS' | 'CRC' | 'HUF' | 'EGP' | 'MYR' | 'VND' | 'PHP' | 'MWK', required
    - `method` object, required
      - `type` 'cpm', required
      - `cpmId` string, required
    - `status` 'PENDING' | 'PROCESSING' | 'SUCCEEDED' | 'FAILED', required
    - `source` object, required
      - `type` 'resell_offer', required
      - `offerId` string, required
    - `history` object[], required
      - `type` 'transfer.created' | 'transfer.processing' | 'transfer.succeeded' | 'transfer.failed', required — The type of the history entry.
      - `date` string, date-time, required — An ISO timestamp indicating the date of the history entry.
      - `userId` string, nullable — The user ID of the history entry.
      - `data` unknown
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `total` number, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/vivenu/apis/vivenu-api.md) · [All operations](https://skmtc.net/vivenu/apis/vivenu-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vivenu/vivenu-api/revisions/36be0dca14e7/schema)