Skip to content
Console
Menu

Alerts and status pages

App store purchases

Credits

Knowledge

KV

Notifications

Organizations

Storage

Workflows

API reference

Getting Started

Authentication

KV Store

List bank receipts

Lists incoming bank evidence, including receipts held for review.

Lists incoming bank evidence, including receipts held for review.

  • Path GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/bank_receipts
  • Scope billing:bank_receipts:read
  • Effect read — nothing is written.
  • Collection bank_receipts
  • Query page_size, page_token, filter
  • Pagination the answer carries bank_receipts and, when there is more, next_page_token

#Request

FieldTypeWhat it is
parentstringEnvironment resource name. Required.
page_sizeint32Default 50, at most 1000.
page_tokenstringToken from the preceding page.
filterstringOptional state equality: held, paid, rejected, refunded or reversed.

#Response

FieldTypeWhat it is
bank_receiptsBankReceipt[]Receipts ordered by creation time and id.
next_page_tokenstringEmpty on the last page.

#BankReceipt

FieldTypeWhat it is
namestringResource name.
uidstringStable resource identity. Output only.
metaResourceMetaResource metadata. Output only.
checkout_sessionstringThe checkout this receipt was submitted against. Output only.
bank_transaction_idstringThe bank statement transaction identity. Output only.
amount_minorint64Amount actually received in minor units. Output only.
currency_codestringCurrency actually received. Output only.
received_timetimestampBank-reported receipt time. Output only.
referencestringReference observed on the bank statement; empty is held. Output only.
payer_evidencestringEvidence locator or statement evidence; screenshots alone are not proof. Output only.
confirmerstringAuthenticated principal that recorded this receipt. Output only.
statestringpaid, held, rejected, refunded or reversed. Output only.
hold_reasonstringWhy settlement was held. Output only.
entriesBankReceiptEntry[]Append-only human resolution, refund and reversal history. Output only.

#ResourceMeta

FieldTypeWhat it is
generationint64Increases by one on every change to spec. Output only.
etagstringStrong ETag (AIP-154): changes on any change to spec, status, or metadata. Send it back as If-Match or etag to make Update and Delete conditional; a mismatch fails with ABORTED / 409 ETAG_MISMATCH. Output only.
create_timetimestampWhen the Resource was created. Output only.
update_timetimestampWhen the Resource last changed. Output only.
delete_timetimestampSet while the Resource is being deleted. Output only.
labelsmap<string, string>Caller-writable, indexed labels (AIP-122 label rules).
annotationsmap<string, string>Caller-writable, unindexed annotations.
display_namestringCaller-writable human-readable name.
creatorstringThe principal that created the Resource. Output only.

#BankReceiptEntry

FieldTypeWhat it is
kindstringaccept, reject, refund or reversal. Output only.
evidencestringOperator evidence supporting this decision. Output only.
confirmerstringAuthenticated decision maker. Output only.
create_timetimestampUTC decision time. Output only.
external_referencestringBank refund/reversal reference, when applicable. Output only.

#Errors

Every error arrives in the body Errors describes.

#Examples

curl "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/bank_receipts" \
  -H "Authorization: Bearer $SYLPHX_API_KEY"