Skip to content
Sidwell
Documentation

Connect. Ask. Verify.

A quick guide to getting started.

Status
API live
In plain terms

Connect, check, ask, verify. Four steps, plus the API.

Start here

Four steps to an answer.

The API below is for developers.
  1. 1

    Connect

    Add a database or upload a spreadsheet. Passwords are encrypted.

  2. 2

    Check columns

    Sidwell labels each column. Fix any mistake.

  3. 3

    Ask

    Type a question in plain English.

  4. 4

    Open the receipt

    See the exact calculation behind every answer.

For developers

The main endpoints.

Every request is signed in and limited to your firm.
MethodEndpointDescription
GET/POST/api/sourcesList and add data sources.
GET/POST/api/datasetsAdd a table. Edit column labels.
POST/api/ingestion/datasetUpload a CSV or Excel file.
POST/api/chatAsk a question.
GET/api/chat/historyGet past questions and answers.
What you get back

Every answer, fully visible.

One response. Nothing hidden.

The written answer.

response.jsonlive
{
  "text": "Engineering opex exceeded Q2 budget by $420,000 (+14.2%)...",
  "data": { "chart": "bar", "rows": [ /* summary rows only */ ] },
  "plan": { "analysis_type": "variance", "dimension": "department_name" },
  "pushdown_sql": "SELECT d.department_name, SUM(t.actual_amount) - ...",
  "audit_metadata": {
    "trace_id": "tr-8f92-eng-q2",
    "rows_scanned": 18420,
    "rows_egressed": 5,
    "duration_ms": 28
  }
}

More in Innovation & Architecture.

Get Started

Connect your first source.

Start with sample data, or bring your own.

Request a demoBack to Overview