v2/projects/{projectId}/forms/{formId}/values
Returns all non-tabular form values on the form.
This endpoint retrieves persisted values from standard web-form fields such as text inputs, numbers, dates, toggles, single/multi select choices, and signatures. This excludes tabular values (table row values like work log, materials, equipment, and custom tables).
Note: Only questions that have been answered (have a value set) are returned. Unanswered questions will not appear in the response.
Results are sorted by updatedAt in ascending order (oldest first).
To retrieve tabular values, use the GET table values endpoint instead.
Resource Information
| Method and URI | GET https://developer.api.autodesk.com/construction/forms/v2/projects/:projectId/forms/:formId/values |
| Authentication Context | User context required |
| Required OAuth Scopes | data:read |
| Data Format | JSON |
Request
Headers
| Authorization* string | Must be Bearer <token>, where <token> is a three-legged access token obtained via an Authorization Code flow or a Secure Service Account (SSA) flow.
The SSA flow is designed for headless server-to-server operations. While it functions like a two-legged flow (no user interaction), it is classified as three-legged because it preserves user context. |
Request
URI Parameters
| projectId string | The ID of the project.
Use the Data Management API to retrieve the project ID. For more information, see the Retrieve a Project ID tutorial. You need to convert the project ID into a project ID for the Forma API by removing the “b." prefix. For example, a project ID of b.a4be0c34a-4ab7 translates to a project ID of a4be0c34a-4ab7. |
| formId string | The unique identifier of the form.
Use GET forms to retrieve the form ID. |
Request
Query String Parameters
| offset int | The number of records to skip before returning results. Default value: 0. To retrieve subsequent pages, increase the offset by the number of records returned in the previous request. |
| limit int | The number of records to return in a single request. Can be a number between 1 and 100. Defaults to 100. |
| fieldIds array: string: uuid | Repeat this parameter to filter the response to specific field IDs (schema UIDs). You can provide up to 100 field identifiers. |
| sectionUid string | Filter by section UID to retrieve values for a specific section only.
Use GET layout to retrieve section UIDs from the form’s layout. |
Response
HTTP Status Code Summary
| 200 OK | Form field values. |
| 400 Bad Request | The request is invalid due to malformed syntax or a missing request header. |
| 401 Unauthorized | The request lacks valid authentication credentials. |
| 403 Forbidden | The client is authenticated but does not have permission to access the resource. |
| 404 Not Found | The resource cannot be found. |
| 429 Too Many Requests | The request exceeds the rate limit for this resource. |
| 500 Internal Server Error | The request failed due to an internal server error. |
Response
Body Structure (200)
| data array: object | List of non-tabular form values. |
| id string: UUID | Unique identifier for the form value. |
| fieldId string: UUID | Unique identifier for the field (schema_uid). Use this to correlate the value with its field definition in the form layout. |
| deleted boolean | Indicates whether this value has been deleted. If true, the value was removed from the form. |
| toggleVal enum:string | Value for toggle/checkbox fields. This endpoint always returns normalized values: True (affirmative), False (negative), or NA (not applicable), regardless of the question’s modifier type (yes/no, pass/fail, plus/minus). To determine the original display format (e.g., Yes/No vs Pass/Fail), check the question’s modifier from the GET section endpoint.
Possible values: Yes, No, False, True, Minus, Plus, Fail, Pass, NA |
| textVal string | Value for text input fields. |
| numberVal number | Value for number input fields. |
| choiceVal string | Value for single-select dropdown or radio button fields. Contains the selected option value. |
| arrayVal array: string | Value for multi-select fields. Contains an array of selected option values. |
| dateVal string | Value for date fields. Date in ISO-8601 format (YYYY-MM-DD). |
| svgVal string | Value for signature fields. Contains the signature as a base64-encoded SVG string. |
| name string | Name of the person who provided the signature. Only populated for signature fields. |
| notes string | Additional notes or comments associated with the field value. |
| updatedAt datetime: ISO 8601 | The date and time when the value was last updated, in UTC ISO-8601 format. |
| updatedBy string | The user ID (Oxygen ID) of the user who last updated this value. |
| pagination object | Pagination information. |
| offset int | The number of results skipped. |
| limit int | The maximum number of results per page. |
| totalResults int | The total number of results. |
| nextUrl string | The URL for the next page of results. The value can be null if it is the last page. |
Example
Form field values.
Request
curl -v 'https://developer.api.autodesk.com/construction/forms/v2/projects/:projectId/forms/:formId/values' \
-H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a'
Response
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"fieldId": "123e4567-e89b-12d3-a456-426614174000",
"deleted": false,
"toggleVal": "True",
"textVal": "Site inspection completed successfully.",
"numberVal": 42.5,
"choiceVal": "Option A",
"arrayVal": [
"Option 1",
"Option 2",
"Option 3"
],
"dateVal": "2026-01-29",
"svgVal": "PHN2ZyBoZWlnaHQ9IjIwMCIgd2lkdGg9IjUwMCI+...",
"name": "John Smith",
"notes": "Verified by site supervisor.",
"updatedAt": "2026-01-29T14:30:00.000000+00:00",
"updatedBy": "USER123ABC"
}
],
"pagination": {
"offset": 0,
"limit": 50,
"totalResults": 1,
"nextUrl": null
}
}