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": false,
  "data": {
    "transaction": {
      "category": {
        "primary": {
          "name": "Shopping",
          "code": {
            "mcc": 5411,
            "sic": 5411,
            "naics": 445110
          }
        },
        "confidence": 50,
        "secondary": {
          "name": "Shopping",
          "code": {
            "mcc": 5411,
            "sic": 5411,
            "naics": 445110
          }
        },
        "tertiary": {
          "name": "Shopping",
          "code": {
            "mcc": 5411,
            "sic": 5411,
            "naics": 445110
          }
        }
      },
      "subscription": {
        "recurring": true,
        "type": "streaming"
      },
      "channel": "in_store",
      "confidence": 50
    },
    "enrichments": {
      "merchant": {
        "status": "found",
        "confidence": 50,
        "data": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "Amazon",
          "alias": [
            "<string>"
          ],
          "keywords": [
            "<string>"
          ],
          "icon": "<string>",
          "description": "<string>",
          "color": "<string>",
          "website": "<string>",
          "domain": "<string>"
        }
      },
      "location": {
        "status": "found",
        "confidence": 123,
        "data": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "formatted": "<string>",
          "structured": {
            "street": "<string>",
            "city": "<string>",
            "state": "<string>",
            "postalCode": "<string>",
            "country": "<string>",
            "countryName": "<string>",
            "coordinates": {
              "latitude": 123,
              "longitude": 123
            },
            "timezone": "<string>"
          },
          "phoneNumber": "<string>"
        }
      },
      "paymentProcessor": {
        "status": "found",
        "confidence": 123,
        "data": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "PayPal",
          "icon": "<string>",
          "color": "<string>",
          "website": "<string>"
        }
      },
      "peerToPeer": {
        "status": "found",
        "confidence": 123,
        "data": {
          "platform": {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "Venmo",
            "icon": "<string>",
            "color": "<string>",
            "website": "<string>"
          },
          "recipient": {
            "displayName": "John Doe"
          },
          "memo": "<string>"
        }
      }
    }
  },
  "meta": {
    "generatedAt": "2023-11-07T05:31:56Z",
    "requestId": "<string>",
    "version": "<string>",
    "categoryVersion": "triqai-2026.01",
    "errors": [
      "location_timeout"
    ]
  }
}

Authorizations

​
X-API-Key
string
header
required

Organization API key for authentication

Body

application/json
​
title
string
required

Transaction title/description from bank statement

Required string length: 1 - 256
Example:

"AMAZON MKTPLACE PMTS AMZN.COM/BILL WA"

​
country
string
required

ISO 3166-1 alpha-2 country code

Example:

"US"

​
type
enum<string>
required

Transaction direction

Available options:
expense,
income
Example:

"expense"

Response

Enrichment successful

​
success
boolean
required
Example:

true

​
partial
boolean
required

True if some enrichers failed but others succeeded

Example:

false

​
data
object
required
​
meta
object
required