Payments for account
This endpoint responds with a collection of Payment operations resources for the account specified in the arguments. Specifically, any payment in which the specified account participates, either as sender or receiver.
This endpoint is particularly useful for following along with payments made by an account. A client can retrieve quick notification about payments made to a specific account by using response streaming.
Request
GET /accounts/{id}/payments{?cursor}{?limit}{?order}
Arguments
name | loc | notes | example | description |
---|---|---|---|---|
id | path | required, string | gspbxqXqEUZkiCCEFFCN9Vu4FLucdjLLdLcsV6E82Qc1T7ehsTC | The address of the account used to constrain results. |
cursor | query | optional, default "" |
8589934592 | A payment paging token specifying from where to begin results. |
limit | query | optional, number, default 10 |
500 | Specifies the count of records at most to return. |
order | query | optional, string, default "asc" |
desc | Specifies order of returned results. "asc" means older payments first, "desc" mean newer payments first. |
Example
# retrieve the first 25 payment for account
curl https://horizon-testnet.stellar.org/account/gspbxqXqEUZkiCCEFFCN9Vu4FLucdjLLdLcsV6E82Qc1T7ehsTC/payments?limit=25
Response
This endpoint responds with a page of payment operations.
Example
{
"_embedded": {
"records": [
{
"_links": {
"self": {
"href": "/operations/12884905984"
},
"transaction": {
"href": "/transaction/6391dd190f15f7d1665ba53c63842e368f485651a53d8d852ed442a446d1c69a"
},
"precedes": {
"href": "/account/gspbxqXqEUZkiCCEFFCN9Vu4FLucdjLLdLcsV6E82Qc1T7ehsTC/payments?cursor=12884905984&order=asc{?limit}",
"templated": true
},
"succeeds": {
"href": "/account/gspbxqXqEUZkiCCEFFCN9Vu4FLucdjLLdLcsV6E82Qc1T7ehsTC/payments?cursor=12884905984&order=desc{?limit}",
"templated": true
}
},
"id": 12884905984,
"paging_token": "12884905984",
"type": 0,
"type_s": "payment",
"sender": "gspbxqXqEUZkiCCEFFCN9Vu4FLucdjLLdLcsV6E82Qc1T7ehsTC",
"receiver": "gsKuurNYgtBhTSFfsCaWqNb3Ze5Je9csKTSLfjo8Ko2b1f66ayZ",
"currency": {
"code": "XLM"
},
"amount": 1000000000,
"amount_f": 100.00
}
]
},
"_links": {
"next": {
"href": "/account/gspbxqXqEUZkiCCEFFCN9Vu4FLucdjLLdLcsV6E82Qc1T7ehsTC/payments?cursor=12884905984&order=asc{?limit}",
"templated": true
},
"self": {
"href": "/account/gspbxqXqEUZkiCCEFFCN9Vu4FLucdjLLdLcsV6E82Qc1T7ehsTC/payments"
}
}
}
Problems
This endpoint should only respond with standard errors.