Skip to content
Gowd Platform Production

Account statements

GET
/order/v1/banking/accounts/{accountId}/statements

Retrieve the account statement for the informed period.

accountId
required
string format: uuid

Identifier of the account

startDate
string

Start date of the statement period in ISO 8601 format

endDate
string

End date of the statement period in ISO 8601 format

currency
required
string

Currency used for the statement (ISO 4217)

limit
number
default: 500

Maximum number of records returned

sort
string
default: desc
Allowed values: asc desc

Sorting direction for the records

operation
string
Allowed values: in out

Filters records by transaction direction (in or out)

endToEndId
string

Filters records by end-to-end id. Matches the order end-to-end id and the refund end-to-end id

cursor
string

Cursor to continue pagination (use the value returned in nextCursor)

mergeBatch
boolean

When true, merges all transactions belonging to the same batch into a single entry, summing their amounts

The resource was returned successfully

object
params
required

Parameters used to generate the statement

object
startDate

Start date of the statement period in ISO 8601 format

string
endDate

End date of the statement period in ISO 8601 format

string
currency
required

Currency used for the statement (ISO 4217)

string
limit
required

Maximum number of records returned in the statement

number
sort
required

Order of the records (asc or desc)

string
operation

Filters records by transaction direction (in or out)

string
Allowed values: in out
endToEndId

Filters records by end-to-end id

string
nextCursor
required

Cursor to retrieve the next page of results

string
nullable
hasNext
required

Indicates if more records are available for pagination

boolean
data
required

Statement items returned for the requested period

Array<object>
object
orderId
required

Identifier of the order associated with the transaction

string
externalCode
required

External reference code of the transaction

string
transactionId
required

Unique identifier of the transaction

string
transactionDate
required

Date and time of the transaction

string
endToEndId
required

End-to-end identifier of the transaction

string
refundEndToEndId
required

End-to-end identifier of the refund transaction

string
operationType
required

Operation type of the transaction.

string
Allowed values: PAYIN PAYOUT PAYIN_FEE PAYOUT_FEE PAYIN_REFUND PAYIN_REFUND_REVERSE PAYOUT_REFUND PAYIN_REFUND_FEE PAYOUT_REFUND_FEE
amount
required

Transaction amount; negative values indicate debits

string
balance
required

Account balance after the transaction

string
counterparty
required

Counterparty information when available

object
name
required

Counterparty name

string
document
required

Counterparty document information

object
type
required

Document type of the counterparty

string
number
required

Document number of the counterparty

string
ispb
required

ISPB of the counterparty financial institution

string
bankName
required

Name of the counterparty financial institution

string
branch
required

Branch number of the counterparty

string
account
required

Account number of the counterparty

string
accountType
required

Type of the counterparty account

string
paymentMethod
required

Payment method used for the transaction

string
Allowed values: PIX TED TETHER
description
required

Description of the transaction

string
refundId
required

The identifier of the refund transaction

string
batch

Batch information when this transaction belongs to a batch

object
id
required

Id of the batch

string
transactionsCount
required

Total number of child transactions in the batch

number
paidCount
required

Number of child transactions already paid

number
failedCount
required

Number of child transactions that failed

number
pendingCount
required

Number of child transactions still pending

number
paidAmount
required

Amount already paid across all child transactions

string
pendingAmount
required

Amount still pending across all child transactions

string
transactions
required

Child transactions the batch was split into

Array<object>
object
id
required

Id of this child transaction

string
idempotencyKey
required

Idempotency key of this child transaction - the first child reuses the batch idempotencyKey verbatim, later ones suffix it

string
sequence
required

Ordering position of this child transaction within the batch

number
amount
required

Amount of this child transaction

string
status
required

Status of this child transaction

string
Allowed values: INITIAL PENDING PAID EXPIRED ANALYSIS REFUNDED PARTIAL_REFUNDED PARTIALLY_PAID CANCELED ERROR
endToEndId

End-to-end id of this child transaction

string
paidAt

Date this child transaction was paid

string
errorMessage

Error message when this child transaction failed

string
object
error
string
message
string
details
Array<object>
object
field
string
issue
string
description
string

Unauthorized Request

object
error
string
message
string
details
Array<object>
object
field
string
issue
string
description
string
object
error
string
message
string
details
Array<object>
object
field
string
issue
string
description
string