GraphQL

Why GraphQL

Reach for GraphQL when you want a few columns from wide tables, or related tables in one round trip. There are no mutations to learn: the API is read only, so you write queries and subscriptions and nothing else.

• Request the three columns you need from a table with forty, with no overfetching.
• Traverse related tables in a single request instead of stitching REST calls.
• Every dataset publishes a typed schema you can introspect and generate types from.

Example Query and Response

Point your client at the dataset, then select exactly the fields you want:

query RecentTransactions {
  dataset(id: "retail-pos") {
    transactions(first: 100, after: $cursor) {
      txn_id
      total
      ts
    }
  }
}

{
  "data": {
    "dataset": {
      "transactions": [
        { "txn_id": "7d1c…3a", "total": 86.90, "ts": "2026-06-21T17:42:00Z" },
        { "txn_id": "8e2d…5b", "total": 129.99, "ts": "2026-06-21T17:43:11Z" }
      ]
    }
  }
}

Core Types