Provision API v1

Provision API

Connect your systems to everything your teams capture in Provision: form submissions, grid rows, deviations and resource data, straight into your warehouse, BI tool or pipeline.

There is no fixed schema. Each form is a dataset, and its fields are the CSV columns, so the API always matches how your forms are built today.

Example: a Daily Sanitation Check form and the CSV rows it exports as.

How it works

  1. 1Authenticate

    Send your API key as a Bearer token. Keys are issued by Provision on request and only ever reach your own organization's data.

    Authorization: Bearer ak_xxxxxxxx
  2. 2List your datasets

    One entry per form, grid and resource type, plus deviations, with the columns each one currently has.

    GET /v1/datasets
    
    [{ "key": "daily_sanitation_check",
       "columns": [ … ] }, … ]
  3. 3Download and sync

    Page through a dataset as CSV. Send the last row back as a cursor (plus its row_index on grid datasets) to get only what changed since.

    GET /v1/datasets/{key}/csv
        ?modifiedSince=…
        &after=…
        &limit=1000

Rows come back oldest change first. Edited rows come back again, so upsert them.

A page with fewer rows than limit means you're caught up.

In the docs