GetProjectFormsList()

Returns a list of project forms that satisfy the given filter parameters.

  • Quota: 10
Table 1. Parameters
ParameterTypeMax LengthRequiredDescription
apiTokenstring20YYour API security token configured in Field View.
projectIdintegerYThe unique ID of the project.
formTemplateLinkIds Integer[]YThe list of form template link IDs of form templates on the project. The form template link id spans versions of a form template. To get all forms on a project, pass in an empty list.
Note: The list of available FormTemplateLinkIds can be found by calling GetProjectFormTemplates().
includeDeletedbooleanSet this to true to include deleted forms.
createdDateFromDateTimeThe created date from, forms to retrieve.
createdDateToDateTimeThe created date to, forms to retrieve.
statusChangedDateFromDateTimeThe status changed date from, forms to retrieve.
statusChangedDateToDateTimeThe status changed date to, forms to retrieve.
lastmodifiedDateFromDateTimeThe last modified date from, forms to retrieve.
lastmodifiedDateToDateTimeThe last modified date to, forms to retrieve.
lastmodifiedOnServerDateFromDateTimeBeginning date of when the form was last modified on the web or synced to the server from mobile.
lastmodifiedOnServerDateToDateTimeEnd date of when the form was last modified on the web or synced to the server from mobile.
includeDeletedLocationsbooleanSet this to true to return forms from deleted locations.
Note: At least one date range is required and none may be greater than 3 months. If you provide more than one date range in the same call, the system returns only results that meet both ranges, thereby potentially narrowing your results. In addition, this query will only return results for modifications to form header fields such as Title, Status, and OwnedBy (see ProjectFormsListInformation listed below). To get results for associated information, use GetProjectFormsAnswers for form answers, GetProjectFormsComments for answer comments, and GetProjectFormsAttachments for answer photos and documents. Merge the results to get a complete picture of what has changed on forms within the date range.
Table 2. Returns
FieldTypeDescription
ProjectFormsListInformationProjectFormsListInformationProject forms list information structure.

   <ProjectFormsListResponse>
       <Status>
           <Code>SUCCESS</Code>
           <Message>Success.</Message>
       </Status>
       <ProjectFormsListInformation>
           <FormID></FormID>
           <FormTemplateLinkID></FormTemplateLinkID>
           <Deleted></Deleted>
           <FormType></FormType>
           <FormName></FormName>
           <FormTitle></FormTitle>
           <CreatedDate></CreatedDate>
           <OwnedBy></OwnedBy>
           <OwnedByOrganisation></OwnedByOrganisation>
           <IssuedToOrganisation></IssuedToOrganisation>
           <Status></Status>
           <StatusColour></StatusColour>
           <StatusDate></StatusDate>
           <Location></Location>
           <OpenTasks></OpenTasks>
           <ClosedTasks></ClosedTasks>
           <FormExpiryDate></FormExpiryDate>
           <OverDue></OverDue>
           <Complete></Complete>
           <Closed></Closed>
           <ParentFormID></ParentFormID>
           <LastModified></LastModified>
           <LastModifiedOnServer></LastModifiedOnServer>
           <ClosedBy></ClosedBy>
           <FormTemplateID></FormTemplateID>
           <ParentProcessTaskID></ParentProcessTaskID>
       </ProjectFormsListInformation>
   </ProjectFormsListResponse>