Skip to main content
This guide will walk you through making your first transaction enrichment request with the Triqai API.

​
Prerequisites

Before you begin, you’ll need:
  1. A Triqai account (sign up for free)
  2. An API key from your dashboard
Don’t have an account yet? You can test the API in our Playground without signing up.

​
Step 1: Get Your API Key

1

Create an account

Sign up at triqai.com/register. No credit card required for the free tier.
2

Access your dashboard

Navigate to your dashboard after signing in.
3

Copy your API key

Your API key is displayed in the dashboard. It starts with triq_.
Keep your API key secure. Never expose it in client-side code or public repositories.

​
Step 2: Make Your First Request

The core endpoint for transaction enrichment is POST /v1/transactions/enrich. Here’s how to use it: 
curl -X POST https://api.triqai.com/v1/transactions/enrich \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "title": "PP* #56789 MK:678321 LELLO, PORTO Ref:hwjk2-23123 PAGAMENTO",
    "country": "BR",
    "type": "expense"
  }'

​
Step 3: Understand the Response

A successful enrichment returns comprehensive data about the transaction:
Response
{
    "success": true,
    "partial": false,
    "data": {
        "transaction": {
            "category": {
                "primary": {
                    "name": "Books",
                    "code": {
                        "mcc": 5942,
                        "sic": 5942,
                        "naics": 451211
                    }
                },
                "secondary": {
                    "name": "Entertainment",
                    "code": {
                        "mcc": 7832,
                        "sic": 7832,
                        "naics": 713110
                    }
                },
                "tertiary": null,
                "confidence": 100
            },
            "subscription": {
                "recurring": false,
                "type": null
            },
            "channel": "in_store",
            "confidence": 100
        },
        "enrichments": {
            "merchant": {
                "status": "found",
                "confidence": 100,
                "data": {
                    "id": "f3c35551-1eb0-460f-a6bf-ce24c64e941b",
                    "name": "Livraria Lello",
                    "alias": [
                        "Livraria Mais Bonita do Mundo"
                    ],
                    "keywords": [
                        "books",
                        "literature",
                        "culture"
                    ],
                    "icon": "https://logos.triqai.com/images/livrarialellopt",
                    "description": "Historic bookstore and cultural institution in Porto, Portugal",
                    "color": "#002B82",
                    "website": "https://livrarialello.pt",
                    "domain": "livrarialello.pt"
                }
            },
            "location": {
                "status": "found",
                "confidence": 80,
                "data": {
                    "id": "9eda058e-174a-4b9a-8777-4b4d8717c5a3",
                    "name": "Porto",
                    "formatted": "R. das Carmelitas 144, 4050-161 Porto",
                    "phoneNumber": "22 200 2037",
                    "structured": {
                        "city": "Porto",
                        "state": "",
                        "street": "R. das Carmelitas 144",
                        "country": "PT",
                        "timezone": "Europe/Lisbon",
                        "postalCode": "4050-161",
                        "coordinates": {
                            "latitude": 41.1468104,
                            "longitude": -8.6148718
                        },
                        "countryName": "Portugal"
                    }
                }
            },
            "paymentProcessor": {
                "status": "found",
                "confidence": 100,
                "data": {
                    "id": "b9a3152a-d735-4b8c-8bd2-e525a6b3d903",
                    "name": "PayPal",
                    "icon": "https://logos.triqai.com/images/paypalcom",
                    "color": "#002991",
                    "website": "https://paypal.com"
                }
            },
            "peerToPeer": {
                "status": "not_applicable",
                "confidence": 0,
                "data": null
            }
        }
    },
    "meta": {
        "generatedAt": "2026-01-14T09:16:09.430Z",
        "requestId": "019c1da3-5541-7b4c-b20e-bb03363b3333",
        "version": "1.0.0",
        "categoryVersion": "triqai-2026.01"
    }
}

​
Key Response Fields

FieldDescription
successWhether the request completed successfully
partialtrue if some enrichers failed but others succeeded
data.transaction.categoryHierarchical category classification
data.transaction.confidenceOverall enrichment confidence (0-100)
data.enrichments.merchantMerchant identification with branding
data.enrichments.locationGeographic data with coordinates
data.enrichments.paymentProcessorPayment processor detection (if applicable)
data.enrichments.peerToPeerP2P platform detection (if applicable)

​
Step 4: Try Different Transactions

Test with various transaction types to see how Triqai handles different scenarios:
Request
{
  "title": "VENMO PAYMENT TO JOHN DOE",
  "country": "US",
  "type": "expense"
}
Detects Venmo as the P2P platform and extracts the recipient name.

​
Next Steps

Now that you’ve made your first enrichment request, explore these resources:

Authentication

Learn about API key management and security best practices

Core Concepts

Understand how transaction enrichment works in detail

API Reference

Explore all available endpoints and parameters

Error Handling

Learn how to handle errors and edge cases