The VerusTrust Forms API
Build forms, capture field entries, and move your data wherever it needs to go over our clean REST API, secured with token-based auth and hosted on Microsoft Azure.
The VerusTrust Forms API gives you programmatic access to the same forms and submissions your team works with in the field.
Spin up forms, read and write entries, and sync field data straight into your own systems. No manual exports, no copy-paste, no waiting on a dashboard. If you can make an HTTPS request, you can integrate VerusTrust Forms.
What You Can Do with the API
The API is built around one job: getting data in and out of VerusTrust Forms so it can live in the rest of your stack.
Here’s what that looks like in practice.
Move your field data wherever it needs to go
This is what most teams reach for the API to do, and it’s the single biggest reason to use it. Every submission your crews capture (including GPS-tagged, offline-collected data) is available as JSON through the Entries endpoints, so you can stop exporting spreadsheets by hand and start moving data automatically.
You can easily pull your full submission history, or narrow it to a single form or a single user with the formId and userId query parameters. Then push it straight into your data warehouse, BI dashboard, CRM, or back-office system.
Of course, you can do this on whatever cadence you like, whether that’s a nightly sync, an hourly job, or a pull triggered the moment a crew comes back online.
The API is the bridge between what happens on-site and the systems where the rest of your business already runs.
Capture data straight to the blockchain
When a form has blockchain verification switched on, the data submitted to it is anchored on-chain. This creates a tamper-evident record that the entry existed, unchanged, at the moment it was captured.
Driven through the API, that turns VerusTrust Forms into a remarkably simple way to commit structured data to the blockchain without writing a line of smart-contract code: define the form once, then POST entries to it programmatically.
In many cases, the blockchain-enabled form is a feature worth choosing VerusTrust Forms for on its own, as its value reaches well beyond field work.
Any team that needs a verifiable, auditable record gets the benefit even if they never use offline or field data collection at all. This includes compliance sign-offs, chain-of-custody logs, contract attestations, quality checks, and more.
Provision and manage forms programmatically
The API also gives you programmatic control over the forms themselves; list them, fetch one by ID, update it, or remove it.
In practice this is less about authoring complex forms from scratch (the drag-and-drop builder is faster and friendlier for that) and more about managing a catalog at scale.
It’s a quick and easy way to roll a standard form out to a new region, archive forms that are no longer in use, or spin up forms from a template as part of an onboarding or provisioning flow.
How Authentication Works
Every request is authenticated with a Bearer access token. Grab your userToken from the Account page in your VerusTrust Forms portal, exchange it for an access token, and include that token on each call.
Access tokens last 24 hours; use the refresh endpoint to issue a new one without sending your userToken again.
POST https://formbuilder-api.azurewebsites.net/v1/authorization
Content-Type: application/json
{
"userToken": "your-user-token"
}
Returns: an accessToken, a refreshToken, and an expirationDate.
A Quick Example
Once you have an access token, calling the API is a single authenticated request:
GET https://formbuilder-api.azurewebsites.net/v1/forms
Authorization: Bearer your-access-token
Want only the entries for one form? Add a query parameter:
GET https://formbuilder-api.azurewebsites.net/v1/entries?formId=your-form-id
Authorization: Bearer your-access-token
Built for Production
VerusTrust’s overarching developer-first approach is reflected directly in how we’ve set up our Forms API to work:
REST over HTTPS
Predictable, resource-based endpoints that return JSON. Nothing exotic to learn, even if you’re not already familiar with it.
Versioned
All endpoints live under /v1, so your integration won’t break underneath you.
Hosted on Microsoft Azure
The same enterprise-grade infrastructure that runs VerusTrust Forms itself.
Token expiry and refresh
24-hour access tokens plus a refresh flow keep long-running integrations secure and simple.
Endpoint Overview
Three resource groups, eleven endpoints . That’s the whole surface.
| Resource | Method | Endpoint | Purpose |
|---|---|---|---|
|
Authorization |
POST |
/v1/authorization
|
Exchange your userToken for an access token
|
|
Authorization |
POST |
/v1/authorization/refresh
|
Refresh an expired access token
|
|
Forms
|
GET |
/v1/forms
|
List all forms
|
|
Forms
|
POST |
/v1/forms
|
Create a form
|
|
Forms
|
GET
|
/v1/forms/form/{id}
|
Get a form by ID
|
|
Forms
|
PUT |
/v1/forms/form/{id}
|
Update a form
|
|
Forms
|
DELETE |
/v1/forms/form/{id}
|
Delete a form
|
|
Entries |
GET |
/v1/entries
|
List entries (filter by userId or formId)
|
|
Entries
|
POST |
/v1/entries
|
Create an entry
|
|
Entries |
GET |
/v1/entries/entry/{id}
|
Get an entry by ID
|
|
Entries |
DELETE |
/v1/entries/entry/{id}
|
Delete an entry
|
Frequently Asked Questions (FAQs)
What authentication does the API use?
Bearer access tokens. You exchange your account userToken for a 24-hour access token and send it in the Authorization header on each request. A refresh endpoint issues new tokens without re-sending your userToken.
Where is the API hosted?
On Microsoft Azure. That’s the same infrastructure that powers VerusTrust Forms, so your API traffic runs on the same secure, compliant foundation as the product.
Can I export my field data through the API?
Yes. The Entries endpoints return your submissions as JSON, including data captured offline and in the field, so you can sync everything into your own systems on your schedule.
Which plans include API access?
All of them. Yes, that includes the forever free plan!
Start Building in Minutes
Get your API token from your VerusTrust Forms account, then read the full reference to make your first call in minutes.
Sign up free, build your first form, and see results immediately.