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

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

This endpoint returns the effects of a specific account and can be used in streaming mode. Streaming mode allows you to listen for new effects for this account as they are added to the Stellar ledger. If called in streaming mode, Horizon will start at the earliest known effect unless a cursor is set, in which case it will start from that cursor. By setting the cursor value to now, you can stream effects 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-effects-by-account-id)


## OpenAPI

````yaml nodeapi/openapi/horizon-openapi-vc.json GET /accounts/{account_id}/effects
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}/effects:
    get:
      tags:
        - Accounts
      summary: Retrieve an Account's Effects
      description: >-
        This endpoint returns the effects of a specific account and can be used
        in streaming mode. Streaming mode allows you to listen for new effects
        for this account as they are added to the Stellar ledger. If called in
        streaming mode, Horizon will start at the earliest known effect unless a
        cursor is set, in which case it will start from that cursor. By setting
        the cursor value to now, you can stream effects created since your
        request time.
      operationId: GetEffectsByAccountId
      parameters:
        - $ref: '#/components/parameters/AccountIDParam'
        - $ref: '#/components/parameters/CursorParam'
        - $ref: '#/components/parameters/OrderParam'
        - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Links'
                  - oneOf:
                      - $ref: '#/components/schemas/CreateAccount'
                      - $ref: '#/components/schemas/Payment'
                      - $ref: '#/components/schemas/PathPaymentStrictReceive'
                      - $ref: '#/components/schemas/PathPaymentStrictSend'
                      - $ref: '#/components/schemas/AccountMerge'
              examples:
                RetrieveAnAccountsEffects:
                  $ref: '#/components/examples/RetrieveAnAccountsEffects'
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
  schemas:
    Links:
      type: object
      properties:
        _links:
          type: object
          properties:
            self:
              $ref: '#/components/schemas/link'
            next:
              $ref: '#/components/schemas/link'
            prev:
              $ref: '#/components/schemas/link'
    CreateAccount:
      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: create_account
        type_i:
          type: number
          example: 0
        created_at:
          type: string
        transaction_hash:
          type: string
        starting_balance:
          type: string
        funder:
          $ref: '#/components/schemas/address'
        account:
          $ref: '#/components/schemas/address'
      required:
        - id
        - paging_token
        - transaction_successful
        - source_account
        - type
        - type_i
        - created_at
        - transaction_hash
        - starting_balance
        - funder
        - account
    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
    PathPaymentStrictReceive:
      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: path_payment_strict_receive
        type_i:
          type: number
          example: 2
        created_at:
          type: string
        transaction_hash:
          type: string
        asset_type:
          type: string
          enum:
            - native
            - credit_alphanum4
            - credit_alphanum12
        asset_code:
          type: string
        asset_issuer:
          $ref: '#/components/schemas/address'
        from:
          $ref: '#/components/schemas/address'
        to:
          $ref: '#/components/schemas/address'
        amount:
          type: string
        path:
          type: array
          items:
            type: object
            properties:
              asset_type:
                type: string
                enum:
                  - native
                  - credit_alphanum4
                  - credit_alphanum12
              asset_code:
                type: string
              asset_issuer:
                $ref: '#/components/schemas/address'
        source_amount:
          type: string
        destination_min:
          type: string
        source_asset_type:
          type: string
        source_asset_code:
          type: string
        source_asset_issuer:
          $ref: '#/components/schemas/address'
      required:
        - id
        - paging_token
        - transaction_successful
        - source_account
        - type
        - type_i
        - created_at
        - transaction_hash
        - from
        - to
        - amount
        - path
        - source_amount
        - destination_min
    PathPaymentStrictSend:
      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: path_payment_strict_send
        type_i:
          type: number
          example: 13
        created_at:
          type: string
        transaction_hash:
          type: string
        asset_type:
          type: string
          enum:
            - native
            - credit_alphanum4
            - credit_alphanum12
        asset_code:
          type: string
        asset_issuer:
          $ref: '#/components/schemas/address'
        from:
          $ref: '#/components/schemas/address'
        to:
          $ref: '#/components/schemas/address'
        amount:
          type: string
        path:
          type: array
          items:
            type: object
            properties:
              asset_type:
                type: string
                enum:
                  - native
                  - credit_alphanum4
                  - credit_alphanum12
              asset_code:
                type: string
              asset_issuer:
                $ref: '#/components/schemas/address'
        source_amount:
          type: string
        source_max:
          type: string
        source_asset_type:
          type: string
        source_asset_code:
          type: string
        source_asset_issuer:
          $ref: '#/components/schemas/address'
      required:
        - id
        - paging_token
        - transaction_successful
        - source_account
        - type
        - type_i
        - created_at
        - transaction_hash
        - from
        - to
        - amount
        - path
        - source_amount
        - source_asset_type
    AccountMerge:
      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: account_merge
        type_i:
          type: number
          example: 8
        created_at:
          type: string
        transaction_hash:
          type: string
        account:
          $ref: '#/components/schemas/address'
        into:
          $ref: '#/components/schemas/address'
      required:
        - id
        - paging_token
        - transaction_successful
        - source_account
        - type
        - type_i
        - created_at
        - transaction_hash
        - account
        - into
    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:
    RetrieveAnAccountsEffects:
      value:
        _links:
          self:
            href: >-
              https://horizon-testnet.stellar.org/accounts/GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE/effects?cursor=&limit=10&order=asc
          next:
            href: >-
              https://horizon-testnet.stellar.org/accounts/GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE/effects?cursor=147350483860869151-1&limit=10&order=asc
          prev:
            href: >-
              https://horizon-testnet.stellar.org/accounts/GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE/effects?cursor=110694007436259329-1&limit=10&order=desc
        _embedded:
          records:
            - _links:
                operation:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/110694007436259329
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=110694007436259329-1
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=110694007436259329-1
              id: 0110694007436259329-0000000001
              paging_token: 110694007436259329-1
              account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              type: account_created
              type_i: 0
              created_at: '2019-09-11T13:16:44Z'
              starting_balance: '1.0000000'
            - _links:
                operation:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/110694007436259329
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=110694007436259329-3
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=110694007436259329-3
              id: 0110694007436259329-0000000003
              paging_token: 110694007436259329-3
              account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              type: signer_created
              type_i: 10
              created_at: '2019-09-11T13:16:44Z'
              weight: 1
              public_key: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              key: ''
            - _links:
                operation:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/110694007436259330
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=110694007436259330-2
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=110694007436259330-2
              id: 0110694007436259330-0000000002
              paging_token: 110694007436259330-2
              account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              type: account_credited
              type_i: 2
              created_at: '2019-09-11T13:16:44Z'
              asset_type: native
              amount: '355.2904739'
            - _links:
                operation:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/115354197276323841
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=115354197276323841-1
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=115354197276323841-1
              id: 0115354197276323841-0000000001
              paging_token: 115354197276323841-1
              account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              type: account_credited
              type_i: 2
              created_at: '2019-11-18T19:59:40Z'
              asset_type: native
              amount: '688.4065454'
            - _links:
                operation:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/117356420835532801
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=117356420835532801-1
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=117356420835532801-1
              id: 0117356420835532801-0000000001
              paging_token: 117356420835532801-1
              account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              type: account_credited
              type_i: 2
              created_at: '2019-12-18T08:23:35Z'
              asset_type: native
              amount: '355.3887598'
            - _links:
                operation:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/119399833130811393
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=119399833130811393-1
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=119399833130811393-1
              id: 0119399833130811393-0000000001
              paging_token: 119399833130811393-1
              account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              type: trustline_created
              type_i: 20
              created_at: '2020-01-17T20:13:22Z'
              asset_type: credit_alphanum4
              asset_code: USD
              asset_issuer: GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX
              limit: '922337203685.4775000'
            - _links:
                operation:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/119399833130811394
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=119399833130811394-1
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=119399833130811394-1
              id: 0119399833130811394-0000000001
              paging_token: 119399833130811394-1
              account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              type: trade
              type_i: 33
              created_at: '2020-01-17T20:13:22Z'
              seller: GCM4PT6XDZBWOOENDS6FOU22GJQLJPV2GC7VRVII4TFGZBA3ZXNM55SV
              offer_id: '147625249'
              sold_amount: '539.0320108'
              sold_asset_type: native
              bought_amount: '32.8490620'
              bought_asset_type: credit_alphanum4
              bought_asset_code: USD
              bought_asset_issuer: GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX
            - _links:
                operation:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/119399833130811394
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=119399833130811394-3
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=119399833130811394-3
              id: 0119399833130811394-0000000003
              paging_token: 119399833130811394-3
              account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              type: trade
              type_i: 33
              created_at: '2020-01-17T20:13:22Z'
              seller: GBDVKE33GVVMBXX73OHIBRP6RAHKHHW2P4PQVV6UNOKQCOXU7GNUM4QI
              offer_id: '147618811'
              sold_amount: '854.9537682'
              sold_asset_type: native
              bought_amount: '52.0920258'
              bought_asset_type: credit_alphanum4
              bought_asset_code: USD
              bought_asset_issuer: GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX
            - _links:
                operation:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/119400713599217665
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=119400713599217665-2
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=119400713599217665-2
              id: 0119400713599217665-0000000002
              paging_token: 119400713599217665-2
              account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              type: account_debited
              type_i: 3
              created_at: '2020-01-17T20:32:38Z'
              asset_type: credit_alphanum4
              asset_code: USD
              asset_issuer: GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX
              amount: '84.9410878'
            - _links:
                operation:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/147350483860869151
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=147350483860869151-1
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=147350483860869151-1
              id: 0147350483860869151-0000000001
              paging_token: 147350483860869151-1
              account: GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE
              type: account_credited
              type_i: 2
              created_at: '2021-03-06T19:27:33Z'
              asset_type: native
              amount: '0.0000001'

````

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