Skip to main content

​
Automatic Retries

The SDK automatically retries on transient errors (429, 500, 503, 504, and network errors) with exponential backoff. Retry behavior:
  • GET and DELETE requests are always retried
  • POST requests are only retried when an idempotencyKey is provided
  • The Retry-After header is respected when present
  • Defaults: 3 retries, 500ms base delay, 30s max delay
Disable retries entirely: 
const triqai = new Triqai("triq_your_api_key", { maxRetries: 0 });

​
Rate Limiting

Rate limit information is available on successful responses. The SDK handles 429 responses automatically, but you can monitor usage: 
// Via the debug hook
const triqai = new Triqai("triq_your_api_key", {
  onResponse: (info) => {
    // info.headers contains X-RateLimit-* values
  },
});

// Via raw requests
const resp = await triqai.rawGet("/v1/categories");
console.log(resp.rateLimitInfo.remaining);           // tokens left
console.log(resp.rateLimitInfo.limit);               // max tokens
console.log(resp.rateLimitInfo.concurrencyRemaining); // concurrent slots left

​
Health & API Info

const health = await triqai.health();
console.log(health.data.status); // "healthy"

const info = await triqai.apiInfo();
console.log(info.data.version);   // "v1"
console.log(info.data.endpoints);

​
Raw Requests

For endpoints not yet covered by a resource class, or when you need the full HTTP response (headers, rate limit info): 
import type { HttpResponse } from "triqai";

const resp: HttpResponse<any> = await triqai.rawGet("/v1/categories");
console.log(resp.data);          // response body
console.log(resp.rateLimitInfo); // { limit, remaining, ... }
The client also exposes rawPost and rawDelete for other HTTP methods.

​
TypeScript

The SDK is written in TypeScript and ships with complete type definitions. All request and response types are exported: 
import type {
  EnrichRequest,
  EnrichSuccessResponse,
  EnrichedTransaction,
  MerchantData,
  LocationData,
  CategoryInfo,
  EntityResult,
  TransactionType,
  TransactionChannel,
  EnrichmentFieldPath,
} from "triqai";