REST API Reference

Details for calling our REST endpoints and building resilient integrations.

Base URL

Use https://api.sansmercantile.com/v1 for all REST requests.

Request structure

Send JSON payloads with a valid bearer token and explicit content-type headers.

Sample request

fetch('https://api.sansmercantile.com/v1/priv/query', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({ prompt: 'Analyze cash flow for a mid-market portfolio.' }),
});

Response payloads

Responses include status, result, and optional metadata for traceability and system confidence.

Versioning

All production APIs are versioned under /v1. Breaking changes are released with a clear migration path through the docs.