Skip to main content
POST
/
v1
/
transactions
/
enrich
curl --request POST \
  --url https://api.triqai.com/v1/transactions/enrich \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "title": "AMAZON MKTPLACE PMTS AMZN.COM/BILL WA",
  "country": "US",
  "type": "expense"
}
'
{
  "success": true,
  "partial": true,
  "data": {
    "transaction": {
      "category": {
        "primary": {
          "name": "<string>",
          "code": {
            "mcc": 123,
            "sic": 123,
            "naics": 123
          }
        },
        "secondary": {
          "name": "<string>",
          "code": {
            "mcc": 123,
            "sic": 123,
            "naics": 123
          }
        },
        "tertiary": {
          "name": "<string>",
          "code": {
            "mcc": 123,
            "sic": 123,
            "naics": 123
          }
        },
        "confidence": {
          "value": 50,
          "reasons": [
            "<string>"
          ]
        }
      },
      "confidence": {
        "value": 50,
        "reasons": [
          "<string>"
        ]
      }
    },
    "entities": [
      {
        "type": "merchant",
        "role": "<string>",
        "confidence": {
          "value": 50,
          "reasons": [
            "<string>"
          ]
        },
        "data": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "alias": [
            "<string>"
          ],
          "icon": "<string>",
          "color": "<string>",
          "website": "<string>",
          "domain": "<string>",
          "keywords": [
            "<string>"
          ],
          "description": "<string>",
          "category": {
            "primary": {
              "name": "<string>",
              "code": {
                "mcc": 123,
                "sic": 123,
                "naics": 123
              }
            },
            "secondary": {
              "name": "<string>",
              "code": {
                "mcc": 123,
                "sic": 123,
                "naics": 123
              }
            },
            "tertiary": {
              "name": "<string>",
              "code": {
                "mcc": 123,
                "sic": 123,
                "naics": 123
              }
            },
            "confidence": {
              "value": 50,
              "reasons": [
                "<string>"
              ]
            }
          }
        }
      }
    ]
  },
  "meta": {
    "generatedAt": "2023-11-07T05:31:56Z",
    "requestId": "<string>",
    "version": "<string>",
    "categoryVersion": "<string>",
    "transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "errors": [
      "location_timeout"
    ]
  }
}

Authorizations

​
X-API-Key
string
header
required

Public API key

Headers

​
Idempotency-Key
string

Optional idempotency key. X-Idempotency-Key is also accepted and must match when both are sent.

Required string length: 1 - 64
Pattern: ^[a-zA-Z0-9_-]{1,64}$

Query Parameters

​
force
boolean
default:false

Bypass cached result when true.

Body

application/json
​
title
string
required

Raw transaction description from the bank statement.

Required string length: 1 - 256
​
country
string
required

ISO 3166-1 alpha-2 country code (e.g., US, GB, DE). Both upper and lowercase are accepted; the API normalizes to uppercase.

Pattern: ^[A-Za-z]{2}$
​
type
enum<string>
required
Available options:
expense,
income
​
options
object

Optional enrichment controls. Use filters to skip specific entity types, or pre-fill known entity data to improve accuracy and reduce latency.

Mutual exclusivity: a filter flag (e.g. noMerchant) cannot be combined with pre-filled data for the same entity type.

Response

Enrichment completed

​
success
enum<boolean>
required
Available options:
true
​
partial
boolean
required
​
data
object
required
​
meta
object
required