addedOutput schema / properties / card_events
Added value: +{
+ "description": "The half of the history the card issuer does not report: what moved the balance behind the spends. Recorded from Laso's own records, newest first.",
+ "items": {
+ "properties": {
+ "amount": {
+ "description": "US dollars. The amount deposited or requested for withdrawal. Null on a `limitChange` or `cardCreated`.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "balance": {
+ "description": "The balance held with the card issuer immediately after this event, in US dollars.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "card_id": {
+ "description": "The card this event applies to, when it applies to one card rather than the account balance.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "created_at": {
+ "description": "Milliseconds since the epoch.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "destination_address": {
+ "description": "`withdrawal` only. The Base address the payout goes to.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "event_type": {
+ "description": "`deposit`: money settled on the holder's balance. `limitChange`: the card's spend limit was resized, which is what makes a deposit spendable. `cardCreated`: the card was issued. `withdrawal`: a payout requested through `POST /withdraw-card-balance`. One of: deposit, limitChange, cardCreated, withdrawal.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "new_spend_limit": {
+ "description": "`limitChange` only. The card's spend limit after the change, in US dollars.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "previous_spend_limit": {
+ "description": "`limitChange` only. The card's spend limit before the change, in US dollars.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "top_up_id": {
+ "description": "Set on a `deposit` that is the final leg of a top-up paid through `GET /fund-card-balance`. That top-up is already in `top_ups` with its full history, so skip a `deposit` carrying this id rather than counting the money twice.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "withdrawal_id": {
+ "description": "`withdrawal` only. The card issuer's reference for the payout request, which it names when it emails the account holder.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+}
addedOutput schema / properties / top_ups
Added value: +{
+ "description": "Every top-up paid through `GET /fund-card-balance`, newest first, with the transaction hash behind each leg as it lands. A top-up whose payment never settled is omitted. This is the same tracker the account holder sees in the dashboard.",
+ "items": {
+ "properties": {
+ "amount": {
+ "description": "US dollars loaded onto the balance.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "balance_after": {
+ "description": "The balance with the card issuer once this top-up was credited, in US dollars.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "bridge_transaction_hash": {
+ "description": "The burn that started the bridge. Absent for a payment made on Base, which needs no bridge.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "bridge_transaction_url": {
+ "description": "A block explorer link for `bridge_transaction_hash`.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "created_at": {
+ "description": "Milliseconds since the epoch.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "credited_at": {
+ "description": "When the card issuer credited the balance, in milliseconds since the epoch.",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "deposit_address": {
+ "description": "The holder's own deposit address at the card issuer, where the money is delivered.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "failure_reason": {
+ "description": "`failed` only. Why delivery could not complete.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mint_transaction_hash": {
+ "description": "The mint that delivered the money on Base.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mint_transaction_url": {
+ "description": "A block explorer link for `mint_transaction_hash`.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "payer_address": {
+ "description": "The wallet that paid for the top-up.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "payment_network": {
+ "description": "The chain the payment was made on, e.g. `solana` or `base`.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "payment_transaction_hash": {
+ "description": "The settled x402 payment.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "description": "`paid`: the payment settled and delivery has started. `bridging`: the burn is confirmed and the mint is pending, skipped for a payment made on Base. `delivered`: the money arrived at the holder's deposit address but the issuer has not credited it. `credited`: posted to the balance, terminal. `failed`: delivery could not complete, terminal. A `failed` top-up stranded nothing, since the payment credited the Laso account balance instead, so retry or recover it with `POST /withdraw`. One of: paid, bridging, delivered, credited, failed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "top_up_id": {
+ "description": "The id `GET /fund-card-balance` returned for this top-up.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "updated_at": {
+ "description": "When the top-up last advanced a leg, in milliseconds since the epoch.",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+}
