Skip to main content

Overview

The BlinkReceipt Purchase Validation API accepts trip and basket data from a scanned receipt and returns enriched product intelligence alongside promotion qualification results. It is a single-endpoint REST API that works alongside the BlinkReceipt scan pipeline to add value on top of raw receipt data.

Base URL​

https://scan.blinkreceipt.com

Authentication​

Every request must include your license_key as a request parameter (either in the form body or JSON payload). There are no bearer tokens or custom headers required.

{
  "license_key": "YOUR_LICENSE_KEY"
}

If the key is missing the API returns Err01. If the key is invalid it returns Err02. See Error Codes for the full list.

Capabilities​

Product Enrichment​

Each product submitted to the API is matched against the BlinkReceipt product intelligence database. On a successful match the API supplements the raw receipt line item with:

  • Canonical product name
  • Brand
  • Category
  • Size
  • UPC
  • Product image URL

When the match is ambiguous, the API returns a possible_products array ranked by probability so callers can present alternatives or apply their own selection logic.

Promotion Validation​

The API validates submitted basket data against configured promotions and returns two lists:

  • qualifiedPromotions — promotions the basket satisfied, including the reward value, currency, and which products triggered the qualification.
  • unqualifiedPromos — promotions that were evaluated but not satisfied, with an error code and human-readable message explaining why.

To validate against a specific subset of promotions, pass their slugs in the promo_slugs field. Leave the field empty to validate against all promotions configured for your account.

Duplicate Detection​

The API tracks previously submitted receipts and sets isDuplicate: true when it detects that the same receipt has already been submitted. The duplicateBlinkReceiptIds field lists the IDs of the previously accepted records that matched.