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 method will use 20 Compute Units.

Reference: Here

PreviousRetrieve an Account's Operations NextRetrieve an Account's Effects

Last updated 8 months ago

Was this helpful?

Retrieve an Account's Payments

get

/accounts/{account_id}/payments

Path parameters

account_idstringrequired

This account’s public key encoded in a base32 string representation.

Example: GDMQQNJM4UL7QIA66P7R2PZHMQINWZBM77BEBMHLFXD5JEUAHGJ7R4JZ

Query parameters

cursorinteger

A number that points to a specific location in a collection of responses and is pulled from the paging_token value of a record.

Example: 6606617478959105

orderstring · enum

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.

Options: asc, desc

limitinteger

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.

Example: 10

include_failedboolean · enum

Set to true to include failed operations in results. Options include true and false.

Options: true, false

joinany

Set to transactions to include the transactions which created each of the operations in the response.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>/accounts/{account_id}/payments'

200

{
  "_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": [
      {
        "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/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": "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/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": "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/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": "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/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": "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/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": "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/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": "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/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": "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/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": "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/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": "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",
        "_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"
          }
        }
      }
    ]
  }
}

Success