Docs/Public API/Operations API

Operations API

Read created signed issuances and redemptions before or after they are submitted.

GET /operations#

List created or submitted signed reward actions.

List Created actionsbash

curl "https://api.loyfin.com/operations?kind=issuance&status=pending&loyaltyId=0x4242424242424242424242424242424242424242424242424242424242424242&limit=25"

GET /operations/:id#

Read operationbash

curl https://api.loyfin.com/operations/128

SignedOperationjson

{
  "id": "128",
  "kind": "issuance",
  "status": "pending",
  "chainId": "8453",
  "verifyingContract": "0x3333333333333333333333333333333333333333",
  "issuer": "0x1111111111111111111111111111111111111111",
  "holder": "0x2222222222222222222222222222222222222222",
  "loyaltyId": "0x4242424242424242424242424242424242424242424242424242424242424242",
  "amount": "1000",
  "expiresAt": "0",
  "deadline": "0",
  "nonce": "0x7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a",
  "operationHash": "0x9999999999999999999999999999999999999999999999999999999999999999",
  "signature": "0xababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababab",
  "data": "0x",
  "metadata": {
    "loyaltyId": "0x4242424242424242424242424242424242424242424242424242424242424242",
    "name": "Bloom Coffee Rewards",
    "symbol": "BLOOM",
    "media": "ipfs://bafy.../bloom.png",
    "description": "Rewards for Bloom Coffee customers.",
    "contractURI": "",
    "tokenURI": ""
  },
  "relayTxHash": null,
  "createdAt": "2026-06-20T10:15:00.000Z"
}

Filters#

Field	Type	Required	Meaning
`kind`	issuance \| redemption	optional	Only one action type.
`status`	pending \| submitted \| mined \| rejected \| cancelled	optional	Use pending for Created rows.
`issuer`	address	optional	Brand signer.
`loyaltyId`	bytes32	optional	Program ID.
`operationHash`	bytes32	optional	Brand correlation hash.