SEP-24SEP-31SEP-6

Retrieve a List of Transactions

GET 
/transactions

Allows to query list of transactions for desired SEP. This api supports pagination, and it's possible (and recommended) to make multiple requests to query transactions. The last page is reached when the number of elements returned by the endpoint is smaller than provided page_size.

Request

Query Parameters

sep stringrequired

Possible values: [6, 24, 31]

Lookup transactions belonging to this SEP.

order_by string
Possible values: [created_at, transfer_received_at, user_action_required_by]
Specifies field that transactions will be ordered by. Note, that secondary sort is transaction id in ascending value. I.e. when timestamps for 2 or more transactions is identical, they will be sorted by id.
Default value: created_at
order string
Possible values: [asc, desc]
Specifies order. Note, that when the field is null, all transactions with null value will be last, regardless of soring order (NULLS LAST). For example, transfer time may not be specified for some transactions, resulting into transfer_received_at being null. If so, transactions with non-null values will be sorted and returned first, followed by all transactions with null timestamps.
Default value: asc
statuses StatusSEPAll[]

Possible values: [incomplete, completed, refunded, expired, error, pending_stellar, pending_external, pending_user_transfer_start, pending_user_transfer_complete, pending_anchor, pending_trust, pending_user, no_market, too_small, too_large, pending_sender, pending_receiver, pending_transaction_info_update, pending_customer_info_update]

Filters transactions for specified array of statuses. If not provided, filtering is disabled (default behavior)

page_size integer
Size of a single search page. Must be positive.
Default value: 20
page_number integer
Page number to use for continuous search. Page count beings at 0.
Default value: 0

Responses

200

Transaction found.

application/json

Schema

Schema

oneOf

TransactionListSEP6

records

object[]

Array [

idstringrequired

sepstringrequired

Possible values: [6]

kindstringrequired

Possible values: [deposit, deposit-exchange, withdrawal, withdrawal-exchange]

statusStatusSEP6 (string)required

Possible status value for SEP-6 transactions

Possible values: [incomplete, completed, refunded, expired, error, pending_stellar, pending_external, pending_customer_info_update, pending_user_transfer_start, pending_user_transfer_complete, pending_anchor, pending_trust, pending_user, no_market, too_small, too_large]

typestring

The method the user used to deposit or withdraw offchain funds.

amount_expected

object

amountstringrequired

assetstringrequired

amount_in

object

amountstringrequired

assetstringrequired

amount_out

object

amountstringrequired

assetstringrequired

fee_details

object

totalstringrequired

assetstringrequired

details

object[]

Array [

namestringrequired

amountstringrequired

descriptionstring

]

quote_idstring

started_atdate-timerequired

updated_atdate-time

completed_atdate-time

transfer_received_atdate-time

user_action_required_bydate-time

messagestring

refunds

object

amount_refunded

object

amountstringrequired

assetstringrequired

amount_fee

object

amountstringrequired

assetstringrequired

payments

object[]

Array [

idstring

id_typestring

Possible values: [stellar, external]

amount

object

amountstringrequired

assetstringrequired

fee

object

amountstringrequired

assetstringrequired

requested_atdate-time

refunded_atdate-time

]

stellar_transactions

object[]

Array [

idstringrequired

The ID of the transaction in the Stellar network.

memostring

The memo of the transaction in the Stellar network.

memo_typestring

The memo type of the transaction in the Stellar network. Should be present if memo is not null.

Possible values: [text, hash, id]

created_atdate-timerequired

The time the transaction was registered in the Stellar network.

envelopestringrequired

The transaction envelope, containing all the transaction information.

payments

object[]

required

Array [

idstringrequired

The ID of the payment in the Stellar Network.

payment_typestringrequired

The type of payment in the Stellar Network.

Possible values: [payment, path_payment]

Default value: payment

source_accountstringrequired

The account being debited in the Stellar Network.

destination_accountstringrequired

The account being credited in the Stellar Network.

amount

object

required

amountstringrequired

assetstringrequired

]

]

source_accountstring

destination_accountstring

external_transaction_idstring

memostring

memo_typeMemoType (string)

The memo type of the transaction in the Stellar network. Should be present if memo is not null.

Possible values: [text id hash]

refund_memostring

If provided, this memo should be used for refund transactions.

refund_memo_typeMemoType (string)

The memo type of the transaction in the Stellar network. Should be present if memo is not null.

Possible values: [text id hash]

client_domainstring

client_namestring

customers

object

The user that initiated the transaction is both the sender and receiver.

sender

object

StellarId's are objects that identify end-users and SEP-31 Sending Anchors, but not SEP-31 Receiving Anchors.

For a SEP-12 customer, the id field should be sufficient to fully identify the customer in the business' Backend.

For a SEP-31 Sending Anchor, the account and memo fields should be used.

For a SEP-6 or SEP-24 Anchor, the account and memo fields should be used.

idstring

The id of the customer registered through SEP-12.

accountstring

Either the Stellar account or Muxed account address of the on-chain entity.

memostring

The memo value identifying a customer with a shared account, where the shared account is account.

receiver

object

StellarId's are objects that identify end-users and SEP-31 Sending Anchors, but not SEP-31 Receiving Anchors.

For a SEP-12 customer, the id field should be sufficient to fully identify the customer in the business' Backend.

For a SEP-31 Sending Anchor, the account and memo fields should be used.

For a SEP-6 or SEP-24 Anchor, the account and memo fields should be used.

idstring

The id of the customer registered through SEP-12.

accountstring

Either the Stellar account or Muxed account address of the on-chain entity.

memostring

The memo value identifying a customer with a shared account, where the shared account is account.

creator

object

StellarId's are objects that identify end-users and SEP-31 Sending Anchors, but not SEP-31 Receiving Anchors.

For a SEP-12 customer, the id field should be sufficient to fully identify the customer in the business' Backend.

For a SEP-31 Sending Anchor, the account and memo fields should be used.

For a SEP-6 or SEP-24 Anchor, the account and memo fields should be used.

idstring

The id of the customer registered through SEP-12.

accountstring

Either the Stellar account or Muxed account address of the on-chain entity.

memostring

The memo value identifying a customer with a shared account, where the shared account is account.

]

TransactionListSEP24

records

object[]

Array [

idstringrequired

sepstringrequired

Possible values: [24]

kindstringrequired

Possible values: [deposit, withdrawal]

statusStatusSEP24 (string)required

Possible status value for SEP-24 transactions

Possible values: [incomplete, completed, refunded, expired, error, pending_stellar, pending_external, pending_user_transfer_start, pending_user_transfer_complete, pending_anchor, pending_trust, pending_user, no_market, too_small, too_large]

typestring

This field is always empty for SEP-24 transactions.

amount_expected

object

required

amountstringrequired

assetstringrequired

amount_in

object

amountstringrequired

assetstringrequired

amount_out

object

amountstringrequired

assetstringrequired

fee_details

object

totalstringrequired

assetstringrequired

details

object[]

Array [

namestringrequired

amountstringrequired

descriptionstring

]

quote_idstring

started_atdate-timerequired

updated_atdate-time

completed_atdate-time

transfer_received_atdate-time

user_action_required_bydate-time

messagestring

refunds

object

amount_refunded

object

amountstringrequired

assetstringrequired

amount_fee

object

amountstringrequired

assetstringrequired

payments

object[]

Array [

idstring

id_typestring

Possible values: [stellar, external]

amount

object

amountstringrequired

assetstringrequired

fee

object

amountstringrequired

assetstringrequired

requested_atdate-time

refunded_atdate-time

]

stellar_transactions

object[]

Array [

idstringrequired

The ID of the transaction in the Stellar network.

memostring

The memo of the transaction in the Stellar network.

memo_typestring

The memo type of the transaction in the Stellar network. Should be present if memo is not null.

Possible values: [text, hash, id]

created_atdate-timerequired

The time the transaction was registered in the Stellar network.

envelopestringrequired

The transaction envelope, containing all the transaction information.

payments

object[]

required

Array [

idstringrequired

The ID of the payment in the Stellar Network.

payment_typestringrequired

The type of payment in the Stellar Network.

Possible values: [payment, path_payment]

Default value: payment

source_accountstringrequired

The account being debited in the Stellar Network.

destination_accountstringrequired

The account being credited in the Stellar Network.

amount

object

required

amountstringrequired

assetstringrequired

]

]

source_accountstring

destination_accountstringrequired

external_transaction_idstring

memostring

memo_typeMemoType (string)

The memo type of the transaction in the Stellar network. Should be present if memo is not null.

Possible values: [text id hash]

refund_memostring

If provided, this memo should be used for refund transactions.

refund_memo_typeMemoType (string)

The memo type of the transaction in the Stellar network. Should be present if memo is not null.

Possible values: [text id hash]

client_domainstring

client_namestring

customers

object

The user that initiated the transaction is both the sender and receiver.

sender

object

StellarId's are objects that identify end-users and SEP-31 Sending Anchors, but not SEP-31 Receiving Anchors.

For a SEP-12 customer, the id field should be sufficient to fully identify the customer in the business' Backend.

For a SEP-31 Sending Anchor, the account and memo fields should be used.

For a SEP-6 or SEP-24 Anchor, the account and memo fields should be used.

idstring

The id of the customer registered through SEP-12.

accountstring

Either the Stellar account or Muxed account address of the on-chain entity.

memostring

The memo value identifying a customer with a shared account, where the shared account is account.

receiver

object

StellarId's are objects that identify end-users and SEP-31 Sending Anchors, but not SEP-31 Receiving Anchors.

For a SEP-12 customer, the id field should be sufficient to fully identify the customer in the business' Backend.

For a SEP-31 Sending Anchor, the account and memo fields should be used.

For a SEP-6 or SEP-24 Anchor, the account and memo fields should be used.

idstring

The id of the customer registered through SEP-12.

accountstring

Either the Stellar account or Muxed account address of the on-chain entity.

memostring

The memo value identifying a customer with a shared account, where the shared account is account.

creator

object

StellarId's are objects that identify end-users and SEP-31 Sending Anchors, but not SEP-31 Receiving Anchors.

For a SEP-12 customer, the id field should be sufficient to fully identify the customer in the business' Backend.

For a SEP-31 Sending Anchor, the account and memo fields should be used.

For a SEP-6 or SEP-24 Anchor, the account and memo fields should be used.

idstring

The id of the customer registered through SEP-12.

accountstring

Either the Stellar account or Muxed account address of the on-chain entity.

memostring

The memo value identifying a customer with a shared account, where the shared account is account.

]

TransactionListSEP31

records

object[]

Array [

idstringrequired

sepstringrequired

Possible values: [31]

kindstringrequired

Possible values: [receive]

statusStatusSEP31 (string)required

Possible status value for SEP-31 transactions

Possible values: [incomplete, completed, refunded, expired, error, pending_stellar, pending_external, pending_sender, pending_receiver, pending_transaction_info_update, pending_customer_info_update]

typestring

This field is always empty for SEP-31 transactions.

amount_expected

object

amountstringrequired

assetstringrequired

amount_in

object

amountstringrequired

assetstringrequired

amount_out

object

amountstringrequired

assetstringrequired

fee_details

object

totalstringrequired

assetstringrequired

details

object[]

Array [

namestringrequired

amountstringrequired

descriptionstring

]

quote_idstring

started_atdate-timerequired

updated_atdate-time

completed_atdate-time

transfer_received_atdate-time

user_action_required_bydate-time

messagestring

refunds

object

amount_refunded

object

amountstringrequired

assetstringrequired

amount_fee

object

amountstringrequired

assetstringrequired

payments

object[]

Array [

idstring

id_typestring

Possible values: [stellar, external]

amount

object

amountstringrequired

assetstringrequired

fee

object

amountstringrequired

assetstringrequired

requested_atdate-time

refunded_atdate-time

]

stellar_transactions

object[]

Array [

idstringrequired

The ID of the transaction in the Stellar network.

memostring

The memo of the transaction in the Stellar network.

memo_typestring

The memo type of the transaction in the Stellar network. Should be present if memo is not null.

Possible values: [text, hash, id]

created_atdate-timerequired

The time the transaction was registered in the Stellar network.

envelopestringrequired

The transaction envelope, containing all the transaction information.

payments

object[]

required

Array [

idstringrequired

The ID of the payment in the Stellar Network.

payment_typestringrequired

The type of payment in the Stellar Network.

Possible values: [payment, path_payment]

Default value: payment

source_accountstringrequired

The account being debited in the Stellar Network.

destination_accountstringrequired

The account being credited in the Stellar Network.

amount

object

required

amountstringrequired

assetstringrequired

]

]

source_accountstring

destination_accountstring

external_transaction_idstring

memostring

memo_typeMemoType (string)

The memo type of the transaction in the Stellar network. Should be present if memo is not null.

Possible values: [text id hash]

refund_memostring

if provided, this memo should be used for refund transactions.

refund_memo_typeMemoType (string)

The memo type of the transaction in the Stellar network. Should be present if memo is not null.

Possible values: [text id hash]

client_domainstring

client_namestring

customers

object

The Identification info of the sending and receiving customers. If they were created through SEP-12, this object should contain the SEP-12 customer id. Otherwise, the account address of the customer.

sender

object

StellarId's are objects that identify end-users and SEP-31 Sending Anchors, but not SEP-31 Receiving Anchors.

For a SEP-12 customer, the id field should be sufficient to fully identify the customer in the business' Backend.

For a SEP-31 Sending Anchor, the account and memo fields should be used.

For a SEP-6 or SEP-24 Anchor, the account and memo fields should be used.

idstring

The id of the customer registered through SEP-12.

accountstring

Either the Stellar account or Muxed account address of the on-chain entity.

memostring

The memo value identifying a customer with a shared account, where the shared account is account.

receiver

object

StellarId's are objects that identify end-users and SEP-31 Sending Anchors, but not SEP-31 Receiving Anchors.

For a SEP-12 customer, the id field should be sufficient to fully identify the customer in the business' Backend.

For a SEP-31 Sending Anchor, the account and memo fields should be used.

For a SEP-6 or SEP-24 Anchor, the account and memo fields should be used.

idstring

The id of the customer registered through SEP-12.

accountstring

Either the Stellar account or Muxed account address of the on-chain entity.

memostring

The memo value identifying a customer with a shared account, where the shared account is account.

creator

object

StellarId's are objects that identify end-users and SEP-31 Sending Anchors, but not SEP-31 Receiving Anchors.

For a SEP-12 customer, the id field should be sufficient to fully identify the customer in the business' Backend.

For a SEP-31 Sending Anchor, the account and memo fields should be used.

For a SEP-6 or SEP-24 Anchor, the account and memo fields should be used.

idstring

The id of the customer registered through SEP-12.

accountstring

Either the Stellar account or Muxed account address of the on-chain entity.

memostring

The memo value identifying a customer with a shared account, where the shared account is account.

]

Example (from schema)

{}

400

Bad Request

application/json

Schema

Schema

errorstringrequired
idstring

Example (from schema)

{
  "error": "string",
  "id": "string"
}

404

Transaction not found.

application/json

Schema

Schema

errorstringrequired
idstring

Example (from schema)

{
  "error": "string",
  "id": "string"
}