Docs/Public API/Issuances API

Issuances API

Store signed issuance actions and read completed issuance events.

POST /issuances#

Store a brand-signed issuance.

Request bodyjson

{
  "issuance": {
    "issuer": "0x1111111111111111111111111111111111111111",
    "to": "0x2222222222222222222222222222222222222222",
    "loyaltyId": "0x4242424242424242424242424242424242424242424242424242424242424242",
    "amount": "1000",
    "expiresAt": "0",
    "deadline": "0",
    "nonce": "0x7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a",
    "chainId": "8453",
    "verifyingContract": "0x3333333333333333333333333333333333333333",
    "operationHash": "0x9999999999999999999999999999999999999999999999999999999999999999",
    "metadata": {
      "loyaltyId": "0x4242424242424242424242424242424242424242424242424242424242424242",
      "name": "Bloom Coffee Rewards",
      "symbol": "BLOOM",
      "media": "ipfs://bafy.../bloom.png",
      "description": "Rewards for Bloom Coffee customers.",
      "contractURI": "",
      "tokenURI": ""
    },
    "data": "0x"
  },
  "signature": "0xababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababab"
}

Responsejson

{
  "ok": true,
  "duplicate": false,
  "operation": {
    "id": "128",
    "kind": "issuance",
    "status": "pending",
    "chainId": "8453",
    "issuer": "0x1111111111111111111111111111111111111111",
    "holder": "0x2222222222222222222222222222222222222222",
    "loyaltyId": "0x4242424242424242424242424242424242424242424242424242424242424242",
    "amount": "1000",
    "expiresAt": "0",
    "deadline": "0",
    "nonce": "0x7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a"
  }
}

GET /issuances#

List completed issuance events.

List completed issuancesbash

curl "https://api.loyfin.com/issuances?issuer=0x1111111111111111111111111111111111111111&limit=25"

Filters: cursor, limit, issuer, to, loyaltyId, token, and operationHash.

Objects#

POST /issuances returns a stored SignedOperation. GET /issuances returns completed Issuance event objects.