This method returns a list of Advocacy interactions by a constituent.
| Client Servlet | Server Servlet | HTTP Methods Supported | Requires Authentication |
|---|---|---|---|
| CRAdvocacyAPI | SRAdvocacyAPI | GET, POST | Server. |
Call getAdvocacyInteractions to obtain advocacy interactions for a specific constituent. Optionally, specify additional parameters to limit the result set.
Filtering, Sorting and Paging Results
Optionally specify date and time limits or ranges for interaction, publication, expiration or last modification using min and max parameters. The publication, expiration, and last modification dates refer to action alerts. The interacted date is the date on which the calling constituent took action on each alert. Values for these fields and the ranges they define include date, time and time zone offset information in ISO 8601 format. You specify both the date and time when publishing an alert. The time zone offset applied is the one configured for your Luminate Online site.
In order to filter alerts associated with a given issue, you must specify one or more issue_id values. To locate the issue_id value for a particular issue in Luminate Online, select Issues from the Advocacy menu. The ID for each issue appears in parentheses beside its name in the list.
You can further filter the list of results using the list_filter_column and list_filter_text parameters.
To sort the results, specify list_sort_column and list_ascending parameters.
See topic Common Parameters.
Optional. Filter by alert status. Accepts a comma separated list. Active alerts allow qualified participants to take action, inactive and archived alerts do not. Inactive alerts have been active at some point but no longer are, typically because they have expired, but they have not been archived by an administrator. The default is 'active,inactive,archived' (all statuses).
Type advocacyAlertStatus.
Optional. Filter by alert type. Accepts a comma separated list. The default is 'action,lte,vote,call' (all types).
Type advocacyAlertType.
Optional. Filter by alert issues. Accepts a comma separated list of valid Issue IDs. The default is an empty list, which causes this filter to be ignored. Only alerts associated with all of the specified issues will be returned.
Type xsd:positiveInteger.
Optional. Whether the list should be sorted in ascending order.
Type xsd:boolean.
Default is true.
Optional. Security Category filter.
Type xsd:integer.
Optional. The database column that will be used to match the filter text (used with "list_filter_text").
Type xsd:string.
Optional. The text that will be used to filter results.
Type xsd:string.
Optional. The requested page number (used with "list_page_size"). The first page (default) is zero. Only one of "list_record_offset" or "list_page_offset" should be used in a request.
Type xsd:integer.
Optional. The number of results in each page (used with "list_record_offset" or "list_page_offset").
Type xsd:integer.
Default is 25.
Optional. The requested initial record number (used with "list_page_size"). The first record (default) is zero. Only one of "list_record_offset" or "list_page_offset" should be used in a request.
Type xsd:integer.
Optional. The column to sort with (used with "list_ascending").
Type xsd:string.
Optional. Filter by expiration timestamp. If you specify a timestamp, only alerts expiring on or before the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by interaction timestamp. If you specify a timestamp, only interactions on or before the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by last modified timestamp. If you specify a timestamp, only alerts last modified on or before the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by publish timestamp. If you specify a timestamp, only alerts published on or before the specified timstamp will be returned.
Type xsd:dateTime.
Optional. Filter by expiration timestamp. If you specify a timestamp, only alerts expiring on or after the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by interaction timestamp. If you specify a timestamp, only interactions on or after the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by last modified timestamp. If you specify a timestamp, only alerts last modified on or after the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by publish timestamp. If you specify a timestamp, only alerts published on or after the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by alert priority. Accepts a comma separated list. The default is 'high,medium,low' (all priorities).
Type advocacyPriority.
Optional. Filter by alert "restrict by state" setting. Accepts a comma separated list of US Postal abbreviations. The default is an empty list, which causes this filter to be ignored. Only alerts that list all of the specified abbreviations will be returned.
Type xsd:string.
See topic Common Parameters.
Required. Specifies the constituent associated with the alert or action.
Type xsd:nonNegativeInteger.
Optional. Specifies that redirect URLs should be signed with a timestamp and a hash of the query string arguments and a secret key.
Type xsd:boolean.
Default is false.
Optional. Filter by alert status. Accepts a comma separated list. Active alerts allow qualified participants to take action, inactive and archived alerts do not. Inactive alerts have been active at some point but no longer are, typically because they have expired, but they have not been archived by an administrator. The default is 'active,inactive,archived' (all statuses).
Type advocacyAlertStatus.
Optional. Filter by alert type. Accepts a comma separated list. The default is 'action,lte,vote,call' (all types).
Type advocacyAlertType.
Optional. Filter by alert issues. Accepts a comma separated list of valid Issue IDs. The default is an empty list, which causes this filter to be ignored. Only alerts associated with all of the specified issues will be returned.
Type xsd:positiveInteger.
Optional. Whether the list should be sorted in ascending order.
Type xsd:boolean.
Default is true.
Optional. Security Category filter.
Type xsd:integer.
Optional. The database column that will be used to match the filter text (used with "list_filter_text").
Type xsd:string.
Optional. The text that will be used to filter results.
Type xsd:string.
Optional. The requested page number (used with "list_page_size"). The first page (default) is zero. Only one of "list_record_offset" or "list_page_offset" should be used in a request.
Type xsd:integer.
Optional. The number of results in each page (used with "list_record_offset" or "list_page_offset").
Type xsd:integer.
Default is 25.
Optional. The requested initial record number (used with "list_page_size"). The first record (default) is zero. Only one of "list_record_offset" or "list_page_offset" should be used in a request.
Type xsd:integer.
Optional. The column to sort with (used with "list_ascending").
Type xsd:string.
Optional. Filter by expiration timestamp. If you specify a timestamp, only alerts expiring on or before the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by interaction timestamp. If you specify a timestamp, only interactions on or before the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by last modified timestamp. If you specify a timestamp, only alerts last modified on or before the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by publish timestamp. If you specify a timestamp, only alerts published on or before the specified timstamp will be returned.
Type xsd:dateTime.
Optional. Filter by expiration timestamp. If you specify a timestamp, only alerts expiring on or after the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by interaction timestamp. If you specify a timestamp, only interactions on or after the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by last modified timestamp. If you specify a timestamp, only alerts last modified on or after the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by publish timestamp. If you specify a timestamp, only alerts published on or after the specified timestamp will be returned.
Type xsd:dateTime.
Optional. Filter by alert priority. Accepts a comma separated list. The default is 'high,medium,low' (all priorities).
Type advocacyPriority.
Optional. Filter by alert "restrict by state" setting. Accepts a comma separated list of US Postal abbreviations. The default is an empty list, which causes this filter to be ignored. Only alerts that list all of the specified abbreviations will be returned.
Type xsd:string.
See topic HTTP Status Codes.
XML response
<?xml version="1.0" encoding="UTF-8"?>
<getAdvocacyInteractionsResponse interactionCount="30" xsi:schemaLocation="http://convio.com/crm/v1.0 http://service.convio.net/xmlschema/crm.public.v1.xsd" xmlns="http://convio.com/crm/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<interaction>
<interactionId>1001</interactionId>
<interacted>2016-02-01T09:43:44.829-06:00</interacted>
<alert>
<alertId>103</alertId>
<type>action</type>
<status>active</status>
<priority>high</priority>
<url>https://secure2.convio.net/orgname/site/Advocacy?pagename=homepage&id=103</url>
<interactionCount>1000002</interactionCount>
<title>Alert Title</title>
<thumbnail>https://secure2.convio.net/orgname/images/Thumbnails/ActionAlerts/103</thumbnail>
<internalName>Internal Name</internalName>
<description>Description</description>
<category categoryId="1">General</category>
<issues>
<issue issueId="1001">Issue1</issue>
<issue issueId="1002">Issue2</issue>
</issues>
<restrictByState>
<state>TN</state>
<state>TX</state>
</restrictByState>
<modified>2016-02-01T09:43:44.829-06:00</modified>
<publish>2016-02-01T09:43:44.829-06:00</publish>
<expire>2016-02-01T09:43:44.829-06:00</expire>
<targets>
<target>Governor</target>
<target>US Senator</target>
<target>US Representative</target>
<target>State Senator</target>
<target>State Representative</target>
</targets>
<messageSubject>Subject</messageSubject>
<messageSubjectEditable>optional</messageSubjectEditable>
<messageGreeting>Dear</messageGreeting>
<messageOpening>Message Opening Text</messageOpening>
<messageBody>Message Body Text</messageBody>
<messageBodyEditable>optional</messageBodyEditable>
<messageClosing>Sincerely,</messageClosing>
<messageSignature>Signature</messageSignature>
<wordLimit>0</wordLimit>
<position>none</position>
<yeaCount>0</yeaCount>
<nayCount>0</nayCount>
<abstainCount>0</abstainCount>
</alert>
<recipients>
<recipient>
<recipientId>ID</recipientId>
<name>Senator John Q. Public</name>
<url>http://public.senate.gov/contact.cfm</url>
<interactive>true</interactive>
<deliveryOptions>
<delivery>internet</delivery>
</deliveryOptions>
</recipient>
</recipients>
<subject>Subject</subject>
<body>Body</body>
<called>2016-02-01T09:43:44.829-06:00</called>
<contactPosition>ContactPosition</contactPosition>
<contactName>ContactName</contactName>
<reply>Reply</reply>
<note>Note</note>
</interaction>
<interaction>
<interactionId>1002</interactionId>
<interacted>2016-02-01T09:43:44.832-06:00</interacted>
<alert>
<alertId>103</alertId>
<type>action</type>
<status>active</status>
<priority>high</priority>
<url>https://secure2.convio.net/orgname/site/Advocacy?pagename=homepage&id=103</url>
<interactionCount>1000002</interactionCount>
<title>Alert Title</title>
<thumbnail>https://secure2.convio.net/orgname/images/Thumbnails/ActionAlerts/103</thumbnail>
<internalName>Internal Name</internalName>
<description>Description</description>
<category categoryId="1">General</category>
<issues>
<issue issueId="1001">Issue1</issue>
<issue issueId="1002">Issue2</issue>
</issues>
<restrictByState>
<state>TN</state>
<state>TX</state>
</restrictByState>
<modified>2016-02-01T09:43:44.833-06:00</modified>
<publish>2016-02-01T09:43:44.833-06:00</publish>
<expire>2016-02-01T09:43:44.832-06:00</expire>
<targets>
<target>Governor</target>
<target>US Senator</target>
<target>US Representative</target>
<target>State Senator</target>
<target>State Representative</target>
</targets>
<messageSubject>Subject</messageSubject>
<messageSubjectEditable>optional</messageSubjectEditable>
<messageGreeting>Dear</messageGreeting>
<messageOpening>Message Opening Text</messageOpening>
<messageBody>Message Body Text</messageBody>
<messageBodyEditable>optional</messageBodyEditable>
<messageClosing>Sincerely,</messageClosing>
<messageSignature>Signature</messageSignature>
<wordLimit>0</wordLimit>
<position>none</position>
<yeaCount>0</yeaCount>
<nayCount>0</nayCount>
<abstainCount>0</abstainCount>
</alert>
<recipients>
<recipient>
<recipientId>ID</recipientId>
<name>Senator John Q. Public</name>
<url>http://public.senate.gov/contact.cfm</url>
<interactive>true</interactive>
<deliveryOptions>
<delivery>internet</delivery>
</deliveryOptions>
</recipient>
</recipients>
<subject>Subject</subject>
<body>Body</body>
<called>2016-02-01T09:43:44.831-06:00</called>
<contactPosition>ContactPosition</contactPosition>
<contactName>ContactName</contactName>
<reply>Reply</reply>
<note>Note</note>
</interaction>
</getAdvocacyInteractionsResponse>
JSON response
{"getAdvocacyInteractionsResponse":{"interactionCount":"30","interaction":[{"body":"Body","interactionId":"1001","recipients":{"recipient":{"recipientId":"ID","interactive":"true","name":"Senator John Q. Public","deliveryOptions":{"delivery":"internet"},"url":"http://public.senate.gov/contact.cfm"}},"contactName":"ContactName","subject":"Subject","alert":{"position":"none","internalName":"Internal Name","messageSubjectEditable":"optional","messageSubject":"Subject","nayCount":"0","yeaCount":"0","messageSignature":"Signature","type":"action","title":"Alert Title","alertId":"103","interactionCount":"1000002","description":"Description","priority":"high","publish":"2016-02-01T09:43:44.839-06:00","targets":{"target":["Governor","US Senator","US Representative","State Senator","State Representative"]},"messageGreeting":"Dear","messageBody":"Message Body Text","abstainCount":"0","expire":"2016-02-01T09:43:44.839-06:00","messageBodyEditable":"optional","status":"active","messageOpening":"Message Opening Text","url":"https://secure2.convio.net/orgname/site/Advocacy?pagename=homepage&id=103","modified":"2016-02-01T09:43:44.839-06:00","messageClosing":"Sincerely,","category":{"content":"General","categoryId":"1"},"thumbnail":"https://secure2.convio.net/orgname/images/Thumbnails/ActionAlerts/103","restrictByState":{"state":["TN","TX"]},"wordLimit":"0","issues":{"issue":[{"content":"Issue1","issueId":"1001"},{"content":"Issue2","issueId":"1002"}]}},"called":"2016-02-01T09:43:44.838-06:00","reply":"Reply","contactPosition":"ContactPosition","interacted":"2016-02-01T09:43:44.839-06:00","note":"Note"},{"body":"Body","interactionId":"1002","recipients":{"recipient":{"recipientId":"ID","interactive":"true","name":"Senator John Q. Public","deliveryOptions":{"delivery":"internet"},"url":"http://public.senate.gov/contact.cfm"}},"contactName":"ContactName","subject":"Subject","alert":{"position":"none","internalName":"Internal Name","messageSubjectEditable":"optional","messageSubject":"Subject","nayCount":"0","yeaCount":"0","messageSignature":"Signature","type":"action","title":"Alert Title","alertId":"103","interactionCount":"1000002","description":"Description","priority":"high","publish":"2016-02-01T09:43:44.840-06:00","targets":{"target":["Governor","US Senator","US Representative","State Senator","State Representative"]},"messageGreeting":"Dear","messageBody":"Message Body Text","abstainCount":"0","expire":"2016-02-01T09:43:44.840-06:00","messageBodyEditable":"optional","status":"active","messageOpening":"Message Opening Text","url":"https://secure2.convio.net/orgname/site/Advocacy?pagename=homepage&id=103","modified":"2016-02-01T09:43:44.840-06:00","messageClosing":"Sincerely,","category":{"content":"General","categoryId":"1"},"thumbnail":"https://secure2.convio.net/orgname/images/Thumbnails/ActionAlerts/103","restrictByState":{"state":["TN","TX"]},"wordLimit":"0","issues":{"issue":[{"content":"Issue1","issueId":"1001"},{"content":"Issue2","issueId":"1002"}]}},"called":"2016-02-01T09:43:44.839-06:00","reply":"Reply","contactPosition":"ContactPosition","interacted":"2016-02-01T09:43:44.839-06:00","note":"Note"}]}}
http://example.com/site/SRAdvocacyAPI?method=getAdvocacyInteractions&cons_id=10001001&api_key=exampleKey&v=1.0&login_name=exampleName&login_password=examplePassword