List payment transactions

Paginated list of the on-chain transactions detected for a payment.

GET/v1/payments/{paymentId}/transactionsAPI key

Path parameters

Field	Type	Description
`paymentId`required	string	Payment ID

Query parameters

Field	Type	Description
`order`optional	string	Sort order by id: asc = ascending, anything else = descending
`order` values string `ascdesc`
`limit`optional	integer	Page size (default 20, max 100)
`lastId`optional	string	Pagination cursor: last id from the previous page

Response

200 OK

Field Type Description

hasMoreoptional boolean True when more transactions exist beyond this page. To fetch the next page, pass the last item's id as the lastId query parameter.

itemsoptional TransactionResponse[] Page of transactions, ordered per the request's order parameter.

items fields TransactionResponse

Field	Type	Description
`acceptedAt`optional	integer	Unix-milliseconds timestamp when the transfer reached the accepted (safe) confirmation tier. Null before acceptance.
`amount`optional	string	On-chain transfer amount, an integer string in the asset's smallest unit (see CreatePaymentRequest.amount).
`detectedAt`optional	integer	Unix-milliseconds timestamp when the transfer was first seen on-chain.
`txHash`optional	string	On-chain transaction hash of the transfer.

Errors

401 Unauthorized404 Not Found500 Internal Server Error— each returns { errorCode, message, args? }. Codes, retries and limits: Errors & limits

All Payments endpoints

Request

terminal

curl https://api.suward.com/v1/payments/<payment_id>/transactions \
  -H "X-Api-Key: $SUWARD_API_KEY"

request.js

const response = await fetch('https://api.suward.com/v1/payments/<payment_id>/transactions', {
  method: 'GET',
  headers: {
    'X-Api-Key': process.env.SUWARD_API_KEY,
  },
});
const data = await response.json();

main.go

package main
 
import (
	"fmt"
	"io"
	"net/http"
	"os"
)
 
func main() {
	req, _ := http.NewRequest("GET", "https://api.suward.com/v1/payments/<payment_id>/transactions", nil)
	req.Header.Set("X-Api-Key", os.Getenv("SUWARD_API_KEY"))
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

request.py

import requests, os
 
response = requests.get(
    'https://api.suward.com/v1/payments/<payment_id>/transactions',
    headers={'X-Api-Key': os.environ['SUWARD_API_KEY']},
)
data = response.json()

Response · 200 OK

response.json

{
  "hasMore": false,
  "items": []
}

Illustrative values. Every field, type and status on this page is generated from the OpenAPI specification.

PreviousQuote payment fees NextStatic Wallets

Something unclear? payments@suward.com — we treat every integration question as a documentation defect.