Transactions - Triqai

The transactions resource provides methods for enriching raw transaction strings and managing enriched transaction records.

Enrich a Transaction

Transform a raw bank transaction string into structured data:

const result = await triqai.transactions.enrich({
  title: "AMAZON MKTPLACE PMTS AMZN.COM/BILL WA",
  country: "US",
  type: "expense",
});

console.log(result.data.transaction.category.primary.name);
console.log(result.data.entities);

Enrichment Options

Use the options field to control extraction behavior. You can skip entity types you don’t need or pre-fill known data to improve accuracy:

const result = await triqai.transactions.enrich({
  title: "AMAZON MKTPLACE PMTS AMZN.COM/BILL WA",
  country: "US",
  type: "expense",
  options: {
    filters: {
      noLocation: true,
      noIntermediary: true,
    },
    merchant: {
      name: "Amazon",
    },
  },
});

You cannot combine a filter (e.g. noMerchant) with pre-filled data for the same entity type — the request will return a 422 validation error.

Idempotent Enrichment

Pass an idempotencyKey to safely retry enrichment requests without consuming extra credits:

const result = await triqai.transactions.enrich(
  { title: "STARBUCKS", country: "US", type: "expense" },
  { idempotencyKey: "my-unique-key-123" },
);

List Transactions

Retrieve paginated lists of previously enriched transactions:

const page = await triqai.transactions.list({
  page: 1,
  size: 50,
  startDate: "2026-01-01T00:00:00Z",
  endDate: "2026-03-01T00:00:00Z",
});

console.log(page.data);     // EnrichedTransaction[]
console.log(page.pageInfo); // { page, size, total, totalPages }

if (page.hasNextPage) {
  const nextPage = await page.nextPage();
}

Auto-Paginate

Use for await...of to iterate through all pages automatically:

const page = await triqai.transactions.list();

for await (const tx of page) {
  console.log(tx.id, tx.raw, tx.status);
}

Get a Transaction

Retrieve a single enriched transaction by ID:

const tx = await triqai.transactions.get(
  "550e8400-e29b-41d4-a716-446655440000"
);

Delete a Transaction

Remove a transaction record:

const { deleted, transactionId } = await triqai.transactions.delete(
  "550e8400-e29b-41d4-a716-446655440000"
);

​Enrich a Transaction

​Enrichment Options

​Idempotent Enrichment

​List Transactions

​Auto-Paginate

​Get a Transaction

​Delete a Transaction

Enrich a Transaction

Enrichment Options

Idempotent Enrichment

List Transactions

Auto-Paginate

Get a Transaction

Delete a Transaction