Use this request to retrieve information about your subscribers' interactions with forms.
Elements
| Data Element | Type | Length | Conditional | Description |
|---|---|---|---|---|
| subscriber_id | Int | -1 | True | The subscriber's unique ID |
| brand_id | Int | True | Your unique Brand ID | |
| String | 100 | True | The subscriber's email address | |
| user_id | String | 50 | True | The subscriber's unique ID in the AMS/CRM database |
| form_id | Int | True | The unique ID of the form | |
| form_name | String | 100 | True | The name of the form |
| activity_date | Datetime | True | The date on which the subscriber used the form | |
| form_version | Int | True | The version of the form | |
| is_new_subscriber | String | 3 | True | Whether the subscriber is new |
| count | Int | False | The number of matches based on the specified criteria |
Request
<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
<Password></Password>
<Brand id="9999">Brand Name</Brand>
<User></User>
<Grids>
<Grid type="subscriber_form_usage">
<ReturnFields>
<DataElement>subscriber_id</DataElement>
<DataElement>brand_id</DataElement>
<DataElement>email</DataElement>
<DataElement>user_id</DataElement>
<DataElement>form_id</DataElement>
<DataElement>form_name</DataElement>
<DataElement>activity_date</DataElement>
<DataElement>form_version</DataElement>
<DataElement>is_new_subscriber</DataElement>
</ReturnFields>
</Grid>
</Grids>
</GridRequest>
Response
<?xml version="1.0" encoding="utf-8"?>
<GridResponse xmlns="http://partner.informz.net/aapi/2009/08/">
<Brand id="9999">Brand Name</Brand>
<User></User>
<Grids>
<Grid type="subscriber_form_usage">
<Record row="1">
<Fields>
<Field element="subscriber_id">000000000</Field>
<Field element="brand_id">9999</Field>
<Field element="email">email@domain.com</Field>
<Field element="user_id">000000000</Field>
<Field element="form_id">9999</Field>
<Field element="form_name">Name of Form</Field>
<Field element="activity_date">2015-01-27T13:19:00.0000000Z</Field>
<Field element="form_version">0</Field>
<Field element="is_new_subscriber">No</Field>
</Fields>
</Record>
</Grid>
</Grids>
</GridResponse>