For the complete documentation index, see llms.txt. This page is also available as Markdown.

List the post-settlement tasks on a receipt

List the post-settlement tasks on a receipt in complete form, including the full attempt history. Use this to inspect why a task failed before retrying.

Set waitSeconds to long poll: the response is held until every task has reached a final state (COMPLETE, FAILED or SKIPPED), or until the wait runs out, whichever comes first. The tasks are returned in their state at that moment. Without waitSeconds, or with 0, the response returns immediately.

Required permissions: SALES_ORDER,RETURN_ORDER

get
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/tasks
Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
waitSecondsinteger · max: 60Optional

How many seconds to wait for every task to reach a final state before returning. 0 or omitted returns immediately. Maximum 60.

Responses
200

The post-settlement tasks on a receipt.

application/json
get/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/tasks
GET /v2/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/tasks HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

The post-settlement tasks on a receipt.

{
  "items": [
    {
      "orderReceiptTaskUid": "text",
      "taskType": "LOYALTY_POINTS_SYNC",
      "status": "PENDING",
      "attempts": [
        {
          "attempt": 1,
          "timestamp": "2026-01-01T00:00:00.000Z",
          "triggeredBy": "text",
          "trigger": "text",
          "outcome": "text",
          "error": "text",
          "response": "text",
          "requestId": "text"
        }
      ],
      "createdAt": "2026-01-01T00:00:00.000Z",
      "lastModifiedAt": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Last updated

Was this helpful?