API endpoint that will return the requested record by ID.
Note: This API documentation is intended to give the reader an overview of the APIs capabilities and how to access them. When trying to write API calls, we strongly recommend you use the API documentation directly associated with the specific API key you will be calling. That documentation includes examples with the actual IDs of the form and form elements, includes examples for each field available in the associated forms etc. This will allow direct copy-paste of the code snippets from the documentation into your code. If you were to try and use the examples in this documentation, you would have to modify them for the fields, form ID, etc.
HTTP request
GET https://api.gwapps.com/v1/forms/formId/records/recordId
Parameters
| Parameter | Description | Type |
|---|---|---|
| Required path parameters | ||
| formId | The current formId 66b18359dc7659dc4cb98d15 | string |
| recordId | The recordId | string |
| Optional query parameters | ||
| fields | Comma separated list of fields (See the Overview section to get the list of available fields) | string |
| includeAttachments | Returns the attachments with a downloadable link when the record data contains attachments fields. The url link for each attachment has an expiration of 10 mins | boolean |
Example Request
GET https://api.gwapps.com/v1/forms/66b18359dc7659dc4cb98d15/records/recordId
Response
The response returned will have the record information, where
| Attribute | Description | Type |
|---|---|---|
| _id | The record ID | string |
| stage | The record’s stage | Stage |
| shortCode | Depends on field type | Each value is different depending on the field type |
Example Response
{
"kind": "form#record",
"_id": "recordId",
"meta": {
"appId": "6266db8cbd86d9001a70c9ea",
"formId": "66b18359dc7659dc4cb98d15"
},
"stage": "stg0",
"text1": "Example Text"
}
Related API Articles
This article covers details for a specific API call/endpoint. Details of the overall Records API structure and calls/endpoints can be found in the GW Apps Records API article. Information on creating API Keys can be found within the API section of the Platform Settings, and in the Security > API Keys section of Edit App within each application.