Taggun

These are the Taggun actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Add Merchant Name

  Tool to add a merchant name keyword to your account's model for predicting merchant names. Use when you want to improve merchant name recognition by training the model with specific merchant names. Changes to your account's model are updated daily and will affect future receipt processing.

• Export Known Merchants

  Export the complete list of known merchants used for merchant name normalization in Taggun. Returns CSV data with merchant details including location IDs, names, addresses, and coordinates. Use this when you need to retrieve the full merchant registry for synchronization, auditing, or analysis. No parameters required - this is a read-only GET operation.

• Export Known Product Codes

  Export the complete list of known product codes used for product normalization and matching in Taggun. Returns CSV data with product code information. Use this when you need to retrieve the full product code registry for synchronization, auditing, or analysis. No parameters required - this is a read-only GET operation.

• Export Product Categories

  Export a list of product categories and descriptions used for product categorization in CSV format. Returns CSV data with product category information for analysis or synchronization purposes. Use this when you need to retrieve the complete product category registry.

• Process Receipt via URL

  Extract structured data from a receipt or invoice image using OCR. Provide a public URL to a receipt/invoice image (JPEG, PNG, PDF, GIF) and get back extracted fields like total amount, date, merchant name, tax, line items, and confidence scores. Use this when you need to digitize receipt/invoice data from a publicly accessible image URL. The API uses machine learning OCR to detect and extract key fields automatically.

• Transcribe Receipt Encoded Verbose

  Tool to transcribe a receipt using base64 encoded image in JSON payload and return detailed results. Use when you have a base64 encoded receipt image and require comprehensive output including line items, merchant details, and confidence levels. The image must be larger than 1x1 pixels to avoid validation errors.

• Transcribe Receipt File (Simple)

  Tool to upload a receipt or invoice image file and extract basic data including merchant name, total amount, tax amount, and date. Use when you need to digitize receipt data from a file (PDF, JPG, PNG, GIF, HEIC up to 20MB). The API uses OCR to detect and extract key fields.

• Transcribe Receipt from Base64 Encoded Image

  Extract structured data from a receipt or invoice using base64 encoded image data. Provide a base64 encoded image (JPEG, PNG, PDF, GIF) along with filename and content type to get back extracted fields like total amount, date, merchant name, tax, line items, and confidence scores. Use this when you have receipt/invoice image data already encoded as base64 and need to digitize the data. The API uses machine learning OCR to detect and extract key fields automatically.

• URL Validation

  Tool to extract and validate receipt data from a URL. Processes a receipt image from a public URL and returns extracted fields with confidence levels to assess receipt authenticity. Use when you have a receipt URL and need to verify it contains valid receipt data.

• URL Verbose

  Tool to process a receipt or invoice from a URL for detailed data extraction. Use when you have a publicly accessible receipt or invoice URL and require comprehensive output including line items, merchant details, and confidence metrics. Call after verifying the URL is reachable.

• Generate Merchants CSV

  Generate a CSV file with mock merchant data for testing purposes. Creates a temporary CSV file with the specified number of merchant rows, including fields like name, alias, address, coordinates, contact info, and tags. Use this when you need sample merchant data for bulk import operations or testing merchant-related API endpoints. The generated CSV follows a standard format with 10 columns: name, alias, address, postcode, lat, lng, country, phone, email, tags.

• Import Known Merchants

  Import a list of merchant names and addresses to normalize and match in CSV or TSV format. Use this when you need to bulk upload merchant data for name normalization and matching. File must be less than 20MB and contain merchant information in CSV or TSV format.

• Import Known Product Codes

  Tool to import a list of product codes in CSV or TSV format for normalization and matching. Use when you need to upload product code data to Taggun for receipt/invoice processing. The file should contain product codes with descriptions (e.g., code,description columns).

• Import Product Categories

  Import a list of product categories and descriptions for product categorization. Accepts CSV or TSV files (less than 20MB) with category and description columns. Use this when you need to bulk import product category data for matching during receipt processing.