> ## Documentation Index
> Fetch the complete documentation index at: https://docs.validationcloud.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Strict Receive Payment Paths

> The strict receive payment path endpoint lists the paths a payment can take based on the amount of an asset you want the recipient to receive. The destination asset amount stays constant, and the type and amount of an asset sent varies based on offers in the order books.

For this search, Horizon loads a list of assets available to the sender (based on `source_account` or `source_assets`) and displays the possible paths from the different source assets to the destination asset. Only paths that satisfy the `destination_amount` are returned.


This method will use `10` [Compute Units](/nodeapi/about/billing).

***


## OpenAPI

````yaml nodeapi/openapi/bundled-stellar-horizon-vc-urls.json GET /paths/strict-receive
openapi: 3.1.0
info:
  title: Horizon
  version: 0.0.1
  summary: >-
    Horizon provides an HTTP API to data in the Stellar network. It ingests and
    re-serves the data produced by the Stellar network in a form that is easier
    to consume by the average application relative to the performance-oriented
    data representations used by Stellar Core. This API serves the bridge
    between apps and Stellar Core. Projects like wallets, decentralized
    exchanges, and asset issuers use Horizon to submit transactions, query an
    account balance, or stream events like transactions to an account.
servers:
  - url: https://{network}.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>
    variables:
      network:
        default: mainnet
        enum:
          - mainnet
          - testnet
          - archive
    description: Validation Cloud Stellar Horizon RPC
security: []
tags:
  - name: Accounts
    description: >-
      Users interact with the Stellar network through accounts. Everything else
      in the ledger—assets, offers, trustlines, etc. are owned by accounts, and
      accounts must authorize all changes to the ledger through signed
      transactions.
  - name: Assets
    description: >-
      Assets are representations of value issued on the Stellar network. An
      asset consists of a type, code, and issuer.
  - name: Claimable Balances
    description: >-
      A Claimable Balance represents the transfer of ownership of some amount of
      an asset. Claimable balances provide a mechanism for setting up a payment
      which can be claimed in the future. This allows you to make payments to
      accounts which are currently not able to accept them.
  - name: Effects
    description: >-
      Effects represent specific changes that occur in the ledger as a result of
      successful operations, but are not necessarily directly reflected in the
      ledger or history, as transactions and operations are.
  - name: Fee Stats
    description: >-
      Fee stats are used to predict what fee to set for a transaction before
      submitting it to the network.
  - name: Liquidity Pools
    description: >-
      Liquidity Pools provide a simple, non-interactive way to trade large
      amounts of capital and enable high volumes of trading.
  - name: Ledgers
    description: >-
      Each ledger stores the state of the network at a point in time and
      contains all the changes - transactions, operations, effects, etc. - to
      that state.
  - name: Offers
    description: >-
      Offers are statements about how much of an asset an account wants to buy
      or sell.
  - name: Operations
    description: >-
      Operations are objects that represent a desired change to the ledger:
      payments, offers to exchange currency, changes made to account options,
      etc. Operations are submitted to the Stellar network grouped in a
      Transaction.
  - name: Order Books
    description: An order book is a collections of offers for a specific pair of assets.
  - name: Paths
    description: >-
      Paths provide information about potential path payments. A path can be
      used to populate the necessary fields for a path payment operation.
  - name: Payments
    description: >-
      Payments are objects that represent balance transfer from one address to
      another. Payments are submitted to the Stellar network grouped in a
      Transaction.
  - name: Trade Aggregations
    description: >-
      A trade aggregation represents aggregated statistics on an asset pair
      (base and counter) for a specific time period. Trade aggregations are
      useful to developers of trading clients and provide historical trade data.
  - name: Trades
    description: >-
      When an offer is fully or partially fulfilled, a trade happens. Trades can
      also be caused by successful path payments, because path payments involve
      fulfilling offers. A trade occurs between two parties—base and counter.
      Which is which is either arbitrary or determined by the calling query.
  - name: Transactions
    description: >-
      Transactions are commands that modify the ledger state and consist of one
      or more operations.
paths:
  /paths/strict-receive:
    get:
      tags:
        - Paths
      summary: List Strict Receive Payment Paths
      description: >
        The strict receive payment path endpoint lists the paths a payment can
        take based on the amount of an asset you want the recipient to receive.
        The destination asset amount stays constant, and the type and amount of
        an asset sent varies based on offers in the order books.


        For this search, Horizon loads a list of assets available to the sender
        (based on `source_account` or `source_assets`) and displays the possible
        paths from the different source assets to the destination asset. Only
        paths that satisfy the `destination_amount` are returned.
      operationId: ListStrictReceivePaymentPaths
      parameters:
        - $ref: '#/components/parameters/SourceAccountParam'
        - $ref: '#/components/parameters/SourceAssetsParam'
        - $ref: '#/components/parameters/DestinationAssetTypeParam'
        - $ref: '#/components/parameters/DestinationAssetIssuerParam'
        - $ref: '#/components/parameters/DestinationAssetCodeParam'
        - $ref: '#/components/parameters/DestinationAmountParam'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Path'
              examples:
                ListStrictRecievePaymentPaths:
                  $ref: '#/components/examples/ListStrictReceivePaymentPaths'
      x-codeSamples:
        - lang: Shell
          source: >
            curl
            https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>//paths/strict-receive?\

            source_assets=CNY:GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX&\

            destination_asset_type=credit_alphanum4&\

            destination_asset_code=BB1&\

            destination_asset_issuer=GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN&\

            destination_amount=5
        - lang: JavaScript
          label: '@stellar/stellar-sdk'
          source: |
            var StellarSdk = require("stellar-sdk");
            var server = new StellarSdk.Horizon.Server(
              "https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>/",
            );

            server
              .strictReceivePaths(
                [
                  new StellarSdk.Asset(
                    "CNY",
                    "GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX",
                  ),
                ],
                new StellarSdk.Asset(
                  "BB1",
                  "GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN",
                ),
                "5",
              )
              .call()
              .then(function (resp) {
                console.log(resp);
              })
              .catch(function (err) {
                console.error(err);
              });
        - lang: Python
          label: stellar_sdk
          source: >
            from stellar_sdk import Server, Asset

            server =
            Server("https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>/")


            response = server.strict_receive_paths(
                source=[
                    Asset("CNY", "GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX")
                ],
                destination_asset=Asset(
                    "BB1",
                    "GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN"
                ),
                destination_amount="5"
            ).call()


            print(response)
components:
  parameters:
    SourceAccountParam:
      name: source_account
      in: query
      required: false
      description: >-
        The Stellar address of the sender. Any returned path must start with an
        asset that the sender holds. Using either `source_account` or
        `source_assets` as an argument is required for strict receive path
        payments.
      schema:
        type: string
        example: GDMQQNJM4UL7QIA66P7R2PZHMQINWZBM77BEBMHLFXD5JEUAHGJ7R4JZ
    SourceAssetsParam:
      name: source_assets
      in: query
      required: false
      description: >-
        A comma-separated list of assets available to the sender. Any returned
        path must start with an asset in this list. Each asset is formatted as
        `CODE:ISSUER_ACCOUNT`. For example:
        `USD:GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX`. Using
        either `source_account` or `source_assets` as an argument is required
        for strict receive path payments.
      schema:
        type: string
        example: CNY:GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX
    DestinationAssetTypeParam:
      name: destination_asset_type
      in: query
      required: true
      description: >-
        The type for the destination asset. Either `native`, `credit_alphanum4`,
        or `credit_alphanum12`.
      schema:
        type: string
        enum:
          - native
          - credit_alphanum4
          - credit_alphanum12
    DestinationAssetIssuerParam:
      name: destination_asset_issuer
      in: query
      required: false
      description: >-
        The Stellar address of the issuer of the destination asset. Required if
        the `destination_asset_type` is not `native`.
      schema:
        type: string
        example: GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX
    DestinationAssetCodeParam:
      name: destination_asset_code
      in: query
      required: false
      description: >-
        The code for the destination asset. Required if the
        `destination_asset_type` is not `native`.
      schema:
        type: string
        example: USD
    DestinationAmountParam:
      name: destination_amount
      in: query
      required: true
      description: The amount of the destination asset that should be received.
      schema:
        type: string
        example: '5'
  schemas:
    Path:
      type: object
      properties:
        _embedded:
          type: object
          properties:
            records:
              type: array
              items:
                type: object
                properties:
                  source_asset_type:
                    type: string
                  source_asset_code:
                    type: string
                  source_asset_issuer:
                    $ref: '#/components/schemas/address'
                  source_amount:
                    type: string
                  destination_asset_type:
                    type: string
                  destination_asset_code:
                    type: string
                  destination_asset_issuer:
                    $ref: '#/components/schemas/address'
                  destination_amount:
                    type: string
                  path:
                    type: array
                    items:
                      $ref: '#/components/schemas/schemas-Asset'
              required:
                - source_asset_type
                - source_amount
                - destination_asset_type
                - destination_amount
                - path
    address:
      type: string
      pattern: G[A-Z0-9]{55}
    schemas-Asset:
      type: object
      properties:
        asset_type:
          type: string
        asset_code:
          type: string
        asset_issuer:
          $ref: '#/components/schemas/address'
      required:
        - asset_type
  examples:
    ListStrictReceivePaymentPaths:
      value:
        _embedded:
          records:
            - source_asset_type: credit_alphanum4
              source_asset_code: CNY
              source_asset_issuer: GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX
              source_amount: '28.9871131'
              destination_asset_type: credit_alphanum4
              destination_asset_code: BB1
              destination_asset_issuer: GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN
              destination_amount: '5.0000000'
              path:
                - asset_type: credit_alphanum4
                  asset_code: XCN
                  asset_issuer: GCNY5OXYSY4FKHOPT2SPOQZAOEIGXB5LBYW3HVU3OWSTQITS65M5RCNY
                - asset_type: native
            - source_asset_type: credit_alphanum4
              source_asset_code: CNY
              source_asset_issuer: GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX
              source_amount: '29.0722784'
              destination_asset_type: credit_alphanum4
              destination_asset_code: BB1
              destination_asset_issuer: GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN
              destination_amount: '5.0000000'
              path:
                - asset_type: credit_alphanum4
                  asset_code: ULT
                  asset_issuer: GC76RMFNNXBFDSJRBXCABWLHXDK4ITVQSMI56DC2ZJVC3YOLLPCKKULT
                - asset_type: native
            - source_asset_type: credit_alphanum4
              source_asset_code: CNY
              source_asset_issuer: GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX
              source_amount: '29.4000002'
              destination_asset_type: credit_alphanum4
              destination_asset_code: BB1
              destination_asset_issuer: GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN
              destination_amount: '5.0000000'
              path:
                - asset_type: native
            - source_asset_type: credit_alphanum4
              source_asset_code: CNY
              source_asset_issuer: GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX
              source_amount: '31.8955888'
              destination_asset_type: credit_alphanum4
              destination_asset_code: BB1
              destination_asset_issuer: GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN
              destination_amount: '5.0000000'
              path:
                - asset_type: credit_alphanum4
                  asset_code: USD
                  asset_issuer: GBUYUAI75XXWDZEKLY66CFYKQPET5JR4EENXZBUZ3YXZ7DS56Z4OKOFU
                - asset_type: native
            - source_asset_type: credit_alphanum4
              source_asset_code: CNY
              source_asset_issuer: GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX
              source_amount: '34.7086084'
              destination_asset_type: credit_alphanum4
              destination_asset_code: BB1
              destination_asset_issuer: GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN
              destination_amount: '5.0000000'
              path:
                - asset_type: credit_alphanum4
                  asset_code: USD
                  asset_issuer: GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX
                - asset_type: native

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.