Skip to main content
Beyond transactions, the SDK provides typed methods for looking up enrichment-related resources and submitting issue reports.

Categories

List all available transaction categories:
const { categories, total, categoryVersion } =
  await triqai.categories.list();

for (const cat of categories) {
  console.log(`${cat.name} (level ${cat.level}, type: ${cat.type})`);
}

Merchants

Look up a merchant by ID (returned in enrichment results):
const merchant = await triqai.merchants.get("merchant-uuid");
console.log(merchant.name, merchant.website, merchant.icon);

Locations

Look up a location by ID:
const location = await triqai.locations.get("location-uuid");
console.log(location.formatted, location.structured.city);

Intermediaries

Look up an intermediary (payment processor, wallet, P2P service) by ID:
const intermediary = await triqai.intermediaries.get("intermediary-uuid");
console.log(intermediary.name); // "PayPal", "Square", etc.

Issue Reports

Report enrichment issues and track their resolution.

Create a Report

const report = await triqai.issueReports.create({
  transactionId: "tx-uuid",
  description: "Merchant was identified incorrectly",
  fields: ["entities.merchant.data.name"],
});

List Reports

const page = await triqai.issueReports.list({
  status: "pending",
  transactionId: "tx-uuid",
});

// Auto-paginate
for await (const report of page) {
  console.log(report.id, report.status);
}

Get a Report

const report = await triqai.issueReports.get("report-uuid");