---
title: "Returns list of alternative service to a provided service"
method: GET
path: "/payout/service/{destination_token}/alternatives"
tags: ["Payout Catalog"]
---

# Returns list of alternative service to a provided service

`GET /payout/service/{destination_token}/alternatives`

This **GET** endpoint is used to retrieve a list of alternative services to a provided service. <br> You can use this endpoint to obtain information about other available services and pricing offered by different companies for a particular destination. <br> To use this endpoint, you need to provide the `destination_token` as a required parameter in the URL Path. <br> The response will include a JSON array containing details for each company, including the company name, available alternative services, and pricing.

## Path parameters

- `destination_token` string, required

## Query parameters

- `destination_currency` string
- `show_dynamic_tokens_only` boolean

## Headers

- `Idempotency-Key` string

## Response `200`

Successful operation.

- Service
  - `country_code` string, required — Country code [ISO_3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3)
  - `delivery_type` 'CASH_PICKUP' | 'BANK_DEPOSIT' | 'HOME_DELIVERY' | 'MOBILE_WALLET' | 'MASSPAY_CARD' | 'PAPER_CHECK' | 'BILL' | 'CRYPTOCURRENCY', required — The type of service. I.e. cash pickup, home delivery, etc.
  - `payers` object[], required
    - `destination_token` string, uuid, required — Token that represents the payout destination. 36 characters long
    - `payer_logo` string, byte — base64 representation of the payer logo
    - `payer_name` string, required — Name of payer
    - `exchange_rate` object[], required — Lists all available currencies and their estimated rates
      - `currency_symbol` string, required — Using [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format.
      - `exchange_rate` number, double, required — Estimated rate
    - `fee` number, double, required — Service fee
    - `max_limit` number, double, required — The maximum amount (inclusive) the user can send with this service. 0 if no upper limit
    - `min_limit` number, double, required — The minimum amount (inclusive) the user can send with this service. 0 if no lower limit
    - `source_amount` number, double — Optional return field. Will only show if `limit` parameter is provided
    - `number_of_locations` integer — Total number of locations. Mostly relevant for cash pickup services. 0 if unknown or irrelevant
    - `estimated_availability` string, date-time — Estimated availability of funds. When funds would be available to pickup/deposited
    - `additional_description` string — When available, additional description that explains the service offered or requirements for funds delivery.
    - `is_dynamic_token` boolean, required — When set to true, it indicates that this destination_token will auto retry the transaction for a set time until it is successful or timesout. False value means the transaction will be processed by the payer in real-time with instant feedback on success/failure.
    - `is_variable_fee` boolean, required — Indicates whether the fee is variable. When set to true, you can expect the fee to change based on the `source_amount`. Although certain crypto currencies's fee can vary due to network fee flactuation, they are not considered a variable fee as MassPay's fee is not variable based on the `source_amount`.
    - `is_generic` boolean, required — Indicates whether the payer is generic. When true, institution-specific details are provided dynamically via attributes rather than being tied to a predefined institution configuration.

## Other responses

- `400` — Bad request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not found.
- `405` — Method Not Allowed.
- `500` — Internal server error.
- `504` — Gateway Time-out.

---

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