Consumer Activity — GET /api/consumer/activity

The activity endpoint returns the authenticated consumer’s most recent payment transactions. Payments where the consumer’s wallet address appears as the sender are marked "out"; payments where it appears as the merchant/recipient SCA are marked "in". Each entry includes a block-explorer link when an on-chain hash exists.

Endpoint

GET https://flarehq.xyz/api/consumer/activity

Request

Headers

Header	Value
`Cookie`	`consumer_token=...` — required

This is a browser route authenticated by the consumer_token cookie set at POST /api/consumer/session. The wallet address is resolved from the cookie’s JWT payload.

Response

boolean

true on success.

array

The 20 most recent matching payments, newest first.

Show activity fields

string

Unique payment reference (e.g. arc_ref_...).

number

Payment amount.

string

Currency code, e.g. "USDC".

string

Payment status, e.g. "SUCCESS" / "FAILED" / "PENDING".

string

ISO timestamp of the payment.

string

"out" when the consumer was the sender, "in" when the consumer was the recipient.

string

For "out" payments: the recipient — the merchant’s SCA address if present, else the merchant name. For "in" payments: the sender’s identifier.

string | null

https://explorer.arc.io/tx/{arcTxHash} when the payment has an on-chain hash, otherwise null.

Examples

curl https://flarehq.xyz/api/consumer/activity \
  -b cookies.txt

const res = await fetch('https://flarehq.xyz/api/consumer/activity', {
  credentials: 'include', // sends the consumer_token cookie
});

const { success, activity } = await res.json();

Success Response

{
  "success": true,
  "activity": [
    {
      "reference": "arc_ref_k7x2m9lp4d8f1q2z",
      "amount": 25,
      "currency": "USDC",
      "status": "SUCCESS",
      "timestamp": "2026-08-16T09:30:00.000Z",
      "direction": "out",
      "counterparty": "0x5b7d4a6f8c0e2b9a1d3f5c7e9a0b2d4f6a1c3e5b",
      "explorerUrl": "https://explorer.arc.io/tx/0x5f1e0c8b7d99a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8"
    },
    {
      "reference": "arc_ref_3a8f6c2e1b4d7a9c",
      "amount": 5.5,
      "currency": "USDC",
      "status": "PENDING",
      "timestamp": "2026-08-16T08:45:00.000Z",
      "direction": "in",
      "counterparty": "0x9f2a1c3e5b7d4a6f8c0e2b9a1d3f5c7e9a0b2d4f",
      "explorerUrl": null
    }
  ]
}

Error Responses

{
  "success": false,
  "error": "Sign in required."
}

{
  "success": false,
  "error": "internal error message"
}

Notes

Activity is matched by wallet address against both the senderEmail field and the merchantSCA field of the payment log. If the consumer is the sender the direction is "out"; otherwise, when their address appears as the merchant SCA, it is "in".

explorerUrl is null until the payment has an on-chain transaction hash — gateway-settled payments may not have one immediately. Link out to the returned URL to let consumers verify transactions on the Arc Mainnet explorer.

Overview

Payments

Escrow

Streaming

CCTP Bridge

Checkout

x402

Agents

Jobs

Merchant

Consumer

Payroll

Consumer Activity — GET /api/consumer/activity

Endpoint

Request

Headers

Response

Examples

Success Response

Error Responses

Notes

​Endpoint

​Request

​Headers

​Response

​Examples

​Success Response

​Error Responses

​Notes

Endpoint

Request

Headers

Response

Examples

Success Response

Error Responses

Notes