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

# Retrieve an Account's Payments

> This endpoint represents successful payments for a given account and can be used in streaming mode. Streaming mode allows you to listen for new payments for this account as they are added to the Stellar ledger. If called in streaming mode, Horizon will start at the earliest known payment unless a cursor is set, in which case it will start from that cursor. By setting the cursor value to now, you can stream payments created since your request time.

This endpoint represents successful payments for a given account and can be used in streaming mode. Streaming mode allows you to listen for new payments for this account as they are added to the Stellar ledger. If called in streaming mode, Horizon will start at the earliest known payment unless a cursor is set, in which case it will start from that cursor. By setting the cursor value to now, you can stream payments created since your request time.

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

***

## Reference: [Here](https://developers.stellar.org/docs/data/apis/horizon/api-reference/get-payments-by-account-id)


## OpenAPI

````yaml nodeapi/openapi/horizon-openapi-vc.json GET /accounts/{account_id}/payments
openapi: 3.0.3
info:
  title: Horizon
  version: 0.0.1
servers:
  - url: https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>
    description: The Pubnet Network
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: Order Books
    description: An order book is a collections of offers for a specific pair of assets.
  - 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:
  /accounts/{account_id}/payments:
    get:
      tags:
        - Accounts
      summary: Retrieve an Account's Payments
      description: >-
        This endpoint represents successful payments for a given account and can
        be used in streaming mode. Streaming mode allows you to listen for new
        payments for this account as they are added to the Stellar ledger. If
        called in streaming mode, Horizon will start at the earliest known
        payment unless a cursor is set, in which case it will start from that
        cursor. By setting the cursor value to now, you can stream payments
        created since your request time.
      operationId: GetPaymentsByAccountId
      parameters:
        - $ref: '#/components/parameters/AccountIDParam'
        - $ref: '#/components/parameters/CursorParam'
        - $ref: '#/components/parameters/OrderParam'
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/IncludeFailedParam'
        - $ref: '#/components/parameters/JoinParam'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Links'
                  - $ref: '#/components/schemas/Payment'
              examples:
                RetrieveAnAccountsPayments:
                  $ref: '#/components/examples/RetrieveAnAccountsPayments'
components:
  parameters:
    AccountIDParam:
      name: account_id
      in: path
      required: true
      description: This account’s public key encoded in a base32 string representation.
      schema:
        type: string
        example: GDMQQNJM4UL7QIA66P7R2PZHMQINWZBM77BEBMHLFXD5JEUAHGJ7R4JZ
    CursorParam:
      name: cursor
      in: query
      required: false
      description: >-
        A number that points to a specific location in a collection of responses
        and is pulled from the paging_token value of a record.
      schema:
        type: integer
        example: 6606617478959105
    OrderParam:
      name: order
      in: query
      required: false
      description: >-
        A designation of the order in which records should appear. Options
        include asc (ascending) or desc (descending). If this argument isn’t
        set, it defaults to asc.
      schema:
        type: string
        enum:
          - asc
          - desc
    LimitParam:
      name: limit
      in: query
      required: false
      description: >-
        The maximum number of records returned. The limit can range from 1 to
        200 - an upper limit that is hardcoded in Horizon for performance
        reasons. If this argument isn’t designated, it defaults to 10.
      schema:
        type: integer
        example: 10
    IncludeFailedParam:
      name: include_failed
      in: query
      required: false
      description: >-
        Set to true to include failed operations in results. Options include
        true and false.
      schema:
        type: boolean
        enum:
          - true
          - false
    JoinParam:
      name: join
      in: query
      required: false
      description: >-
        Set to transactions to include the transactions which created each of
        the operations in the response.
      schema:
        type: string
  schemas:
    Links:
      type: object
      properties:
        _links:
          type: object
          properties:
            self:
              $ref: '#/components/schemas/link'
            next:
              $ref: '#/components/schemas/link'
            prev:
              $ref: '#/components/schemas/link'
    Payment:
      type: object
      properties:
        _embedded:
          type: object
          properties:
            records:
              type: array
              items:
                type: object
                properties:
                  _links:
                    type: object
                    properties:
                      self:
                        $ref: '#/components/schemas/link'
                      transaction:
                        $ref: '#/components/schemas/link'
                      effects:
                        $ref: '#/components/schemas/link'
                      succeeds:
                        $ref: '#/components/schemas/link'
                      precedes:
                        $ref: '#/components/schemas/link'
                    required:
                      - self
                      - transaction
                      - effects
                      - succeeds
                      - precedes
                  id:
                    $ref: '#/components/schemas/id'
                  paging_token:
                    type: string
                  transaction_successful:
                    type: boolean
                  source_account:
                    $ref: '#/components/schemas/address'
                  type:
                    type: string
                    example: payment
                  type_i:
                    type: string
                  created_at:
                    type: string
                  transaction_hash:
                    type: string
                  asset_type:
                    type: string
                  asset_code:
                    enum:
                      - native
                      - credit_alphanum4
                      - credit_alphanum12
                  asset_issuer:
                    $ref: '#/components/schemas/address'
                  from:
                    $ref: '#/components/schemas/address'
                  to:
                    $ref: '#/components/schemas/address'
                  amount:
                    type: string
                required:
                  - id
                  - paging_token
                  - transaction_successful
                  - source_account
                  - type
                  - type_i
                  - created_at
                  - transaction_hash
                  - asset_type
                  - from
                  - to
                  - amount
    link:
      type: object
      properties:
        href:
          type: string
          format: link
        templated:
          type: boolean
      required:
        - href
    id:
      type: string
    address:
      type: string
      pattern: G[A-Z0-9]{55}
  examples:
    RetrieveAnAccountsPayments:
      value:
        _links:
          self:
            href: >-
              https://horizon-testnet.stellar.org/accounts/GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE/payments?cursor=&limit=10&order=asc
          next:
            href: >-
              https://horizon-testnet.stellar.org/accounts/GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE/payments?cursor=148289273518190684&limit=10&order=asc
          prev:
            href: >-
              https://horizon-testnet.stellar.org/accounts/GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE/payments?cursor=110694007436259329&limit=10&order=desc
        _embedded:
          records:
            - _links:
                self:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/110694007436259329
                transaction:
                  href: >-
                    https://horizon-testnet.stellar.org/transactions/26c996aa6afb299b6761f2335277196715160ade6aa001a755116448b145d3a7
                effects:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/110694007436259329/effects
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=110694007436259329
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=110694007436259329
              id: '110694007436259329'
              paging_token: '110694007436259329'
              transaction_successful: true
              source_account: GB44UMO65PK5NWMRP4S2OSZA5BD4ACOW5KQ6TWLLO2MP7S7N5MJ2MJVI
              type: create_account
              type_i: 0
              created_at: '2019-09-11T13:16:44Z'
              transaction_hash: 26c996aa6afb299b6761f2335277196715160ade6aa001a755116448b145d3a7
              starting_balance: '1.0000000'
              funder: GB44UMO65PK5NWMRP4S2OSZA5BD4ACOW5KQ6TWLLO2MP7S7N5MJ2MJVI
              account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
            - _links:
                self:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/110694007436259330
                transaction:
                  href: >-
                    https://horizon-testnet.stellar.org/transactions/26c996aa6afb299b6761f2335277196715160ade6aa001a755116448b145d3a7
                effects:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/110694007436259330/effects
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=110694007436259330
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=110694007436259330
              id: '110694007436259330'
              paging_token: '110694007436259330'
              transaction_successful: true
              source_account: GB44UMO65PK5NWMRP4S2OSZA5BD4ACOW5KQ6TWLLO2MP7S7N5MJ2MJVI
              type: account_merge
              type_i: 8
              created_at: '2019-09-11T13:16:44Z'
              transaction_hash: 26c996aa6afb299b6761f2335277196715160ade6aa001a755116448b145d3a7
              account: GB44UMO65PK5NWMRP4S2OSZA5BD4ACOW5KQ6TWLLO2MP7S7N5MJ2MJVI
              into: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
            - _links:
                self:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/115354197276323841
                transaction:
                  href: >-
                    https://horizon-testnet.stellar.org/transactions/c09d4cee993d60d73c80f036666966738a26b8f3b25d7275b93fd995505b5e5b
                effects:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/115354197276323841/effects
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=115354197276323841
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=115354197276323841
              id: '115354197276323841'
              paging_token: '115354197276323841'
              transaction_successful: true
              source_account: GDV4KECLSZLKRVH4ZTWVAS4I3W2LPAPV66ADFFUZKGIVOTK6GMKGJT53
              type: payment
              type_i: 1
              created_at: '2019-11-18T19:59:40Z'
              transaction_hash: c09d4cee993d60d73c80f036666966738a26b8f3b25d7275b93fd995505b5e5b
              asset_type: native
              from: GDV4KECLSZLKRVH4ZTWVAS4I3W2LPAPV66ADFFUZKGIVOTK6GMKGJT53
              to: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              amount: '688.4065454'
            - _links:
                self:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/117356420835532801
                transaction:
                  href: >-
                    https://horizon-testnet.stellar.org/transactions/c25dd84798076ee8ea126c78407d61c7e8f3efdf8739274f56b07a7029500b00
                effects:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/117356420835532801/effects
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=117356420835532801
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=117356420835532801
              id: '117356420835532801'
              paging_token: '117356420835532801'
              transaction_successful: true
              source_account: GDV4KECLSZLKRVH4ZTWVAS4I3W2LPAPV66ADFFUZKGIVOTK6GMKGJT53
              type: payment
              type_i: 1
              created_at: '2019-12-18T08:23:35Z'
              transaction_hash: c25dd84798076ee8ea126c78407d61c7e8f3efdf8739274f56b07a7029500b00
              asset_type: native
              from: GDV4KECLSZLKRVH4ZTWVAS4I3W2LPAPV66ADFFUZKGIVOTK6GMKGJT53
              to: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              amount: '355.3887598'
            - _links:
                self:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/119400713599217665
                transaction:
                  href: >-
                    https://horizon-testnet.stellar.org/transactions/b9d7c534b5fa168570a5bffe0f2089de150d00bf8cbd19ec93e897c565958f3f
                effects:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/119400713599217665/effects
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=119400713599217665
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=119400713599217665
              id: '119400713599217665'
              paging_token: '119400713599217665'
              transaction_successful: true
              source_account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              type: payment
              type_i: 1
              created_at: '2020-01-17T20:32:38Z'
              transaction_hash: b9d7c534b5fa168570a5bffe0f2089de150d00bf8cbd19ec93e897c565958f3f
              asset_type: credit_alphanum4
              asset_code: USD
              asset_issuer: GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX
              from: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              to: GASWJWFRYE55KC7MGANZMMRBK5NPXT3HMPDQ6SEXZN6ZPWYXVVYBFRTE
              amount: '84.9410878'
            - _links:
                self:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/147350483860869151
                transaction:
                  href: >-
                    https://horizon-testnet.stellar.org/transactions/b53cd1d3a95ad2fd7141b3b800e8cd3af1658d2d72b2274d1bd116cf0e58f193
                effects:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/147350483860869151/effects
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=147350483860869151
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=147350483860869151
              id: '147350483860869151'
              paging_token: '147350483860869151'
              transaction_successful: true
              source_account: GBDSJHAGNQDL2WZ5LBRSIVI6MUHJO6CLKF5XFVUK7GMPUQ4NBLSYVAHX
              type: payment
              type_i: 1
              created_at: '2021-03-06T19:27:33Z'
              transaction_hash: b53cd1d3a95ad2fd7141b3b800e8cd3af1658d2d72b2274d1bd116cf0e58f193
              asset_type: native
              from: GBDSJHAGNQDL2WZ5LBRSIVI6MUHJO6CLKF5XFVUK7GMPUQ4NBLSYVAHX
              to: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              amount: '0.0000001'
            - _links:
                self:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/147354181828010015
                transaction:
                  href: >-
                    https://horizon-testnet.stellar.org/transactions/1be9f5f3dcd28c4fa70f5f5ed79d7332da14741e55a5abe4132d4c04da7b6f1e
                effects:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/147354181828010015/effects
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=147354181828010015
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=147354181828010015
              id: '147354181828010015'
              paging_token: '147354181828010015'
              transaction_successful: true
              source_account: GCVZ5PHDFGUV6YXN7I735RE5AJSFOOWPT4A2WHCGTGXOQ6KVWM3TYEQC
              type: payment
              type_i: 1
              created_at: '2021-03-06T20:49:34Z'
              transaction_hash: 1be9f5f3dcd28c4fa70f5f5ed79d7332da14741e55a5abe4132d4c04da7b6f1e
              asset_type: native
              from: GCVZ5PHDFGUV6YXN7I735RE5AJSFOOWPT4A2WHCGTGXOQ6KVWM3TYEQC
              to: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              amount: '0.0000001'
            - _links:
                self:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/147355590577238047
                transaction:
                  href: >-
                    https://horizon-testnet.stellar.org/transactions/ba6bca6dce0c01d9d9cebcc79466c986b18a8cb3b67030f6424b6563778ab947
                effects:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/147355590577238047/effects
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=147355590577238047
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=147355590577238047
              id: '147355590577238047'
              paging_token: '147355590577238047'
              transaction_successful: true
              source_account: GBDSJHAGNQDL2WZ5LBRSIVI6MUHJO6CLKF5XFVUK7GMPUQ4NBLSYVAHX
              type: payment
              type_i: 1
              created_at: '2021-03-06T21:19:49Z'
              transaction_hash: ba6bca6dce0c01d9d9cebcc79466c986b18a8cb3b67030f6424b6563778ab947
              asset_type: native
              from: GBDSJHAGNQDL2WZ5LBRSIVI6MUHJO6CLKF5XFVUK7GMPUQ4NBLSYVAHX
              to: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              amount: '0.0000001'
            - _links:
                self:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/148286782436462682
                transaction:
                  href: >-
                    https://horizon-testnet.stellar.org/transactions/74afe177a6ecf466899bbdbd339a796e1995a3c8c4084c556849a702759bb7c1
                effects:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/148286782436462682/effects
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=148286782436462682
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=148286782436462682
              id: '148286782436462682'
              paging_token: '148286782436462682'
              transaction_successful: true
              source_account: GDAXCWDQAYP2VC2UR2KRLVD7JQYIYMQ7BGFY647BCG4CFANT7JYNSO4S
              type: payment
              type_i: 1
              created_at: '2021-03-20T12:48:24Z'
              transaction_hash: 74afe177a6ecf466899bbdbd339a796e1995a3c8c4084c556849a702759bb7c1
              asset_type: native
              from: GDAXCWDQAYP2VC2UR2KRLVD7JQYIYMQ7BGFY647BCG4CFANT7JYNSO4S
              to: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              amount: '0.0000001'
            - _links:
                self:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/148289273518190684
                transaction:
                  href: >-
                    https://horizon-testnet.stellar.org/transactions/de50646ece611a9fbd2b222b910f020f94e654064d64fd54f50358d3d13e7f49
                effects:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/148289273518190684/effects
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=148289273518190684
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=148289273518190684
              id: '148289273518190684'
              paging_token: '148289273518190684'
              transaction_successful: true
              source_account: GC2LS7Z564TGWRVCIHTSEIZBO5WUZSNR2MA544FE4JPXMAUMDQI2JR6N
              type: payment
              type_i: 1
              created_at: '2021-03-20T13:42:07Z'
              transaction_hash: de50646ece611a9fbd2b222b910f020f94e654064d64fd54f50358d3d13e7f49
              asset_type: native
              from: GC2LS7Z564TGWRVCIHTSEIZBO5WUZSNR2MA544FE4JPXMAUMDQI2JR6N
              to: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              amount: '0.0000001'

````

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