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.
Path Parameters
- account_id string required
This account’s public key encoded in a base32 string representation.
Query Parameters
- cursor integer
A number that points to a specific location in a collection of responses and is pulled from the paging_token value of a record.
- order string
Possible values: [
asc
,desc
]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.
- limit integer
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.
- include_failed boolean
Possible values: [
true
,false
]Set to true to include failed operations in results. Options include true and false.
- join any
Set to transactions to include the transactions which created each of the operations in the response.
- 200
Success
- application/json
- Schema
- Example (from schema)
- RetrieveAnAccountsPayments
Schema
_links object
self object
href link requiredtemplated booleannext object
href link requiredtemplated booleanprev object
href link requiredtemplated boolean_embedded object
records object[]
Array [_links object
self object required
href link requiredtemplated booleantransaction object required
href link requiredtemplated booleaneffects object required
href link requiredtemplated booleansucceeds object required
href link requiredtemplated booleanprecedes object required
href link requiredtemplated booleanid id requiredpaging_token string requiredtransaction_successful boolean requiredsource_account address requiredPossible values: Value must match regular expression
G[A-Z0-9]{55}
type string requiredtype_i string requiredcreated_at string requiredtransaction_hash string requiredasset_type string requiredasset_codePossible values: [
native
,credit_alphanum4
,credit_alphanum12
]asset_issuer addressPossible values: Value must match regular expression
G[A-Z0-9]{55}
from address requiredPossible values: Value must match regular expression
G[A-Z0-9]{55}
to address requiredPossible values: Value must match regular expression
G[A-Z0-9]{55}
amount string required]
{
"_links": {
"self": {
"href": "string",
"templated": true
},
"next": {
"href": "string",
"templated": true
},
"prev": {
"href": "string",
"templated": true
}
},
"_embedded": {
"records": [
{
"_links": {
"self": {
"href": "string",
"templated": true
},
"transaction": {
"href": "string",
"templated": true
},
"effects": {
"href": "string",
"templated": true
},
"succeeds": {
"href": "string",
"templated": true
},
"precedes": {
"href": "string",
"templated": true
}
},
"id": "string",
"paging_token": "string",
"transaction_successful": true,
"source_account": "string",
"type": "payment",
"type_i": "string",
"created_at": "string",
"transaction_hash": "string",
"asset_type": "string",
"asset_issuer": "string",
"from": "string",
"to": "string",
"amount": "string"
}
]
}
}
{
"_links": {
"self": {
"href": "https://horizon.stellar.org/accounts/GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE/payments?cursor=&limit=10&order=asc"
},
"next": {
"href": "https://horizon.stellar.org/accounts/GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE/payments?cursor=148289273518190684&limit=10&order=asc"
},
"prev": {
"href": "https://horizon.stellar.org/accounts/GCNL55IJTH2HX26HLNIGYD2JIQLTBAQL3SVPNZA6PXK7NAVHU423WOTE/payments?cursor=110694007436259329&limit=10&order=desc"
}
},
"_embedded": {
"records": [
{
"_links": {
"self": {
"href": "https://horizon.stellar.org/operations/110694007436259329"
},
"transaction": {
"href": "https://horizon.stellar.org/transactions/26c996aa6afb299b6761f2335277196715160ade6aa001a755116448b145d3a7"
},
"effects": {
"href": "https://horizon.stellar.org/operations/110694007436259329/effects"
},
"succeeds": {
"href": "https://horizon.stellar.org/effects?order=desc&cursor=110694007436259329"
},
"precedes": {
"href": "https://horizon.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.stellar.org/operations/110694007436259330"
},
"transaction": {
"href": "https://horizon.stellar.org/transactions/26c996aa6afb299b6761f2335277196715160ade6aa001a755116448b145d3a7"
},
"effects": {
"href": "https://horizon.stellar.org/operations/110694007436259330/effects"
},
"succeeds": {
"href": "https://horizon.stellar.org/effects?order=desc&cursor=110694007436259330"
},
"precedes": {
"href": "https://horizon.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.stellar.org/operations/115354197276323841"
},
"transaction": {
"href": "https://horizon.stellar.org/transactions/c09d4cee993d60d73c80f036666966738a26b8f3b25d7275b93fd995505b5e5b"
},
"effects": {
"href": "https://horizon.stellar.org/operations/115354197276323841/effects"
},
"succeeds": {
"href": "https://horizon.stellar.org/effects?order=desc&cursor=115354197276323841"
},
"precedes": {
"href": "https://horizon.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.stellar.org/operations/117356420835532801"
},
"transaction": {
"href": "https://horizon.stellar.org/transactions/c25dd84798076ee8ea126c78407d61c7e8f3efdf8739274f56b07a7029500b00"
},
"effects": {
"href": "https://horizon.stellar.org/operations/117356420835532801/effects"
},
"succeeds": {
"href": "https://horizon.stellar.org/effects?order=desc&cursor=117356420835532801"
},
"precedes": {
"href": "https://horizon.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.stellar.org/operations/119400713599217665"
},
"transaction": {
"href": "https://horizon.stellar.org/transactions/b9d7c534b5fa168570a5bffe0f2089de150d00bf8cbd19ec93e897c565958f3f"
},
"effects": {
"href": "https://horizon.stellar.org/operations/119400713599217665/effects"
},
"succeeds": {
"href": "https://horizon.stellar.org/effects?order=desc&cursor=119400713599217665"
},
"precedes": {
"href": "https://horizon.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.stellar.org/operations/147350483860869151"
},
"transaction": {
"href": "https://horizon.stellar.org/transactions/b53cd1d3a95ad2fd7141b3b800e8cd3af1658d2d72b2274d1bd116cf0e58f193"
},
"effects": {
"href": "https://horizon.stellar.org/operations/147350483860869151/effects"
},
"succeeds": {
"href": "https://horizon.stellar.org/effects?order=desc&cursor=147350483860869151"
},
"precedes": {
"href": "https://horizon.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.stellar.org/operations/147354181828010015"
},
"transaction": {
"href": "https://horizon.stellar.org/transactions/1be9f5f3dcd28c4fa70f5f5ed79d7332da14741e55a5abe4132d4c04da7b6f1e"
},
"effects": {
"href": "https://horizon.stellar.org/operations/147354181828010015/effects"
},
"succeeds": {
"href": "https://horizon.stellar.org/effects?order=desc&cursor=147354181828010015"
},
"precedes": {
"href": "https://horizon.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.stellar.org/operations/147355590577238047"
},
"transaction": {
"href": "https://horizon.stellar.org/transactions/ba6bca6dce0c01d9d9cebcc79466c986b18a8cb3b67030f6424b6563778ab947"
},
"effects": {
"href": "https://horizon.stellar.org/operations/147355590577238047/effects"
},
"succeeds": {
"href": "https://horizon.stellar.org/effects?order=desc&cursor=147355590577238047"
},
"precedes": {
"href": "https://horizon.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.stellar.org/operations/148286782436462682"
},
"transaction": {
"href": "https://horizon.stellar.org/transactions/74afe177a6ecf466899bbdbd339a796e1995a3c8c4084c556849a702759bb7c1"
},
"effects": {
"href": "https://horizon.stellar.org/operations/148286782436462682/effects"
},
"succeeds": {
"href": "https://horizon.stellar.org/effects?order=desc&cursor=148286782436462682"
},
"precedes": {
"href": "https://horizon.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.stellar.org/operations/148289273518190684"
},
"transaction": {
"href": "https://horizon.stellar.org/transactions/de50646ece611a9fbd2b222b910f020f94e654064d64fd54f50358d3d13e7f49"
},
"effects": {
"href": "https://horizon.stellar.org/operations/148289273518190684/effects"
},
"succeeds": {
"href": "https://horizon.stellar.org/effects?order=desc&cursor=148289273518190684"
},
"precedes": {
"href": "https://horizon.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"
}
]
}
}