{"_id":"562bd7961b98640d00714526","user":"55dd9841cafe7221002a4c62","__v":0,"category":{"_id":"562bd5875a39cd0d009aff60","project":"55dd9f2e0efd5821000d54d9","__v":5,"pages":["562bd5eb9ebc950d000f7539","562bd6c832ee000d0084fd7a","562bd74752fb180d0034cc0d","562bd7961b98640d00714526","562bd7f952fb180d0034cc0f"],"version":"55dd9f4dab0e4d210045aae9","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-24T19:01:27.208Z","from_sync":false,"order":31,"slug":"surveys-and-forms-1","title":"Surveys and forms"},"version":{"_id":"55dd9f4dab0e4d210045aae9","__v":39,"project":"55dd9f2e0efd5821000d54d9","createdAt":"2015-08-26T11:13:17.024Z","releaseDate":"2015-08-26T11:13:17.024Z","categories":["55dd9f4dab0e4d210045aaea","55ddb5fa9067202b00ddff6f","55e0472c6bad670d0081f213","55e04764a44fae0d00214671","55e047a9a44fae0d00214672","55e047b258c5460d0076a9a7","55e95e337fc27b2d00d32cf2","55e979bda7ca823900ad549a","55edb8c18dcb210d0056900b","55f0365c8563861700a33765","55f03677d58f9b1900acf996","55f036938eeefc23001ea5de","55f036a38563861700a33767","55f036c08563861700a33769","55f036d02911b72100482cd7","55f036e92911b72100482cd9","55f036fa8563861700a3376b","55f0370ee507711900e58c69","55f0371df6101b1900c70700","55f0374f2911b72100482cdb","55f0375e2911b72100482cdc","560eb0f659cb8d0d0015cd52","560eb25239fad419002ae1e0","561fb64d4d67490d00804b2a","562b9f775a39cd0d009aff22","562ba0505a39cd0d009aff23","562ba149d56bc30d00f0cb18","562ba595f68a5f0d007b1f3b","562ba78fd56bc30d00f0cb1b","562ba8b95a39cd0d009aff27","562baadf6562140d001501d2","562bab37f68a5f0d007b1f3d","562bc1bf9ebc950d000f7523","562bc99ced4bea0d00c11dfa","562bd29c1b98640d00714520","562bd5875a39cd0d009aff60","562bdfabff2da50d002c0aaf","562be0bd5a39cd0d009aff75","57a0b476d8313e1900454439"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"editedParams":true,"project":"55dd9f2e0efd5821000d54d9","editedParams2":true,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-10-24T19:10:14.842Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"code":"<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:v2=\"http://apiconnector.com/v2\" xmlns:apic=\"http://apiconnector.com\">\n   <soapenv:Header/>\n   <soapenv:Body>\n      <v2:CreateAddressBook>\n         <v2:apiAddressBook>\n            <apic:Name>My Address Book</apic:Name>\n            <apic:Visibility>Public</apic:Visibility>\n         </v2:apiAddressBook>\n      </v2:CreateAddressBook>\n   </soapenv:Body>\n</soapenv:Envelope>","language":"xml"}]},"results":{"codes":[{"code":"<s:Envelope xmlns:s=\"http://schemas.xmlsoap.org/soap/envelope/\">\n   <s:Body>\n      <CreateAddressBookResponse xmlns=\"http://apiconnector.com/v2\">\n         <CreateAddressBookResult xmlns:a=\"http://apiconnector.com\" xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\">\n            <a:Id>0</a:Id>\n            <a:Name>My Address Book</a:Name>\n            <a:Visibility>Public</a:Visibility>\n            <a:Contacts>0</a:Contacts>\n         </CreateAddressBookResult>\n      </CreateAddressBookResponse>\n   </s:Body>\n</s:Envelope>","language":"xml","status":200,"name":""}]},"settings":"","auth":"required","params":[{"_id":"55ddbc1e746ace2b00dd6f38","ref":"","in":"body","required":true,"desc":"The name of the address book you're creating. It can't be an existing address book's name, 'Test' or 'All contacts'.","default":"","type":"string","name":"Name"},{"_id":"55ddbc1e746ace2b00dd6f37","ref":"","in":"body","required":false,"desc":"All address books are created as 'Private' by default but you can set it as 'Public' upon creation should you wish to.","default":"","type":"string","name":"Visibility"}],"url":"/v:version/ApiService/CreateAddressBook"},"isReference":false,"order":0,"body":"This method retrieves all existing surveys within the account.\n\nThe select parameter requires a number between 1 and 1000 (0 is not a valid number). You may only select a maximum of 1000 results in a single request.\n\nThe skip parameter should be used in tandem with the select parameter when wanting to iterate through a whole data set. If you want to select the next 1000 records you should set the select parameter to 1000 and the skip parameter to 1000, which will return records 1001 to 2000. You should continue to do this until 0 records are returned to retrieve the whole data set.\n\n**SOAP action:** [https://[region ID]-api.dotmailer.com/v2/ApiService/GetSurveys](doc:getsurveys)\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"The input and output parameters for this method are:\\n\\n**Input parameters** \\n  * assignedToAddressBookOnly - *optional; boolean*\\n  * Select - *optional; string*\\n  * Skip - *optional; string*\\n\\n**Output parameters** \\n  * GetSurveysResult - *array of Survey*\\n       * Survey\\n            * Id - *integer*\\n            * Name - *string*\\n            * Url - *string*\\n            * DateSurveyCreated - *dateTime*\\n            * DateSurveyModified - *dateTime*\\n            * State - *string (Active', 'Inactive', 'Pending', 'Expired', 'SurveyFeatureDisabled')*\\n            * FirstActiveDate - *dateTime*\\n            * LastInactiveDate - *dateTime*\\n            * ScheduledStartDate - *dateTime*\\n            * ScheduledEndDate - *dateTime*\\n            * ConfirmationMode - *string ('Text', 'Url')*\\n            * SubmissionMode - *string ('Single', 'Multiple')*\\n            * FieldCount - *integer*\\n            * NotifyCreatorOnResponse - *boolean*\\n            * RespondentNotificationType - *string ('None', 'Basic', 'Campaign')*\\n            * RespondentNotificationCampaignId - *integer*\\n            * IsAssignedToAddressBook - *boolean*\\n            * AssignedAddressBookTarget - *string('AllContacts', 'SpecificAddressBook')*\\n            * AssignedSpecificAddressBookId - *integer*\\n            * FirstResponseDate - *dateTime*\\n            * LastResponseDate - *dateTime*\\n            * TotalCompleteResponses - *integer*\\n            * TotalCompleteResponsesInLastDay - *integer*\\n            * TotalCompleteResponsesInLastWeek - *integer*\\n            * TotalIncompleteResponses - *integer*\\n            * TotalViews - *integer*\\n            * TotalBounces - *integer*\\n            * TimeToCompleteMax - *integer*\\n            * TimeToCompleteMin - *integer*\\n            * TimeToCompleteTotal - *long*\\n            * SourceDirectTotal - *integer*\\n            * SourceEmailTotal - *integer*\\n            * SourceEmbeddedTotal - *integer*\\n            * SourcePopoverTotal - *integer*\\n            * SourceFacebookTotal - *integer*\\n            * SourceTwitterTotal - *integer*\\n            * SourceGooglePlusTotal - *integer*\\n            * SourceOtherTotal - *integer*\",\n  \"title\": \"Input and output parameters\"\n}\n[/block]\n**Example** \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"using (var client = new ApiServiceClient())\\n{\\n\\tclient.ClientCredentials.UserName.UserName = \\\"username\\\";\\n\\tclient.ClientCredentials.UserName.Password = \\\"password\\\";\\n\\n\\tvar assignedToAddressBookOnly = true;\\n\\tvar select = 1000;\\n\\tvar skip = 0;\\n\\tvar surveys = client.GetSurveys(assignedToAddressBookOnly, select, skip);\\n}\",\n      \"language\": \"csharp\"\n    }\n  ]\n}\n[/block]","excerpt":"Gets a list of all surveys in the account","slug":"getsurveys","type":"basic","title":"GetSurveys"}

GetSurveys

Gets a list of all surveys in the account

This method retrieves all existing surveys within the account. The select parameter requires a number between 1 and 1000 (0 is not a valid number). You may only select a maximum of 1000 results in a single request. The skip parameter should be used in tandem with the select parameter when wanting to iterate through a whole data set. If you want to select the next 1000 records you should set the select parameter to 1000 and the skip parameter to 1000, which will return records 1001 to 2000. You should continue to do this until 0 records are returned to retrieve the whole data set. **SOAP action:** [https://[region ID]-api.dotmailer.com/v2/ApiService/GetSurveys](doc:getsurveys) [block:callout] { "type": "info", "body": "The input and output parameters for this method are:\n\n**Input parameters** \n * assignedToAddressBookOnly - *optional; boolean*\n * Select - *optional; string*\n * Skip - *optional; string*\n\n**Output parameters** \n * GetSurveysResult - *array of Survey*\n * Survey\n * Id - *integer*\n * Name - *string*\n * Url - *string*\n * DateSurveyCreated - *dateTime*\n * DateSurveyModified - *dateTime*\n * State - *string (Active', 'Inactive', 'Pending', 'Expired', 'SurveyFeatureDisabled')*\n * FirstActiveDate - *dateTime*\n * LastInactiveDate - *dateTime*\n * ScheduledStartDate - *dateTime*\n * ScheduledEndDate - *dateTime*\n * ConfirmationMode - *string ('Text', 'Url')*\n * SubmissionMode - *string ('Single', 'Multiple')*\n * FieldCount - *integer*\n * NotifyCreatorOnResponse - *boolean*\n * RespondentNotificationType - *string ('None', 'Basic', 'Campaign')*\n * RespondentNotificationCampaignId - *integer*\n * IsAssignedToAddressBook - *boolean*\n * AssignedAddressBookTarget - *string('AllContacts', 'SpecificAddressBook')*\n * AssignedSpecificAddressBookId - *integer*\n * FirstResponseDate - *dateTime*\n * LastResponseDate - *dateTime*\n * TotalCompleteResponses - *integer*\n * TotalCompleteResponsesInLastDay - *integer*\n * TotalCompleteResponsesInLastWeek - *integer*\n * TotalIncompleteResponses - *integer*\n * TotalViews - *integer*\n * TotalBounces - *integer*\n * TimeToCompleteMax - *integer*\n * TimeToCompleteMin - *integer*\n * TimeToCompleteTotal - *long*\n * SourceDirectTotal - *integer*\n * SourceEmailTotal - *integer*\n * SourceEmbeddedTotal - *integer*\n * SourcePopoverTotal - *integer*\n * SourceFacebookTotal - *integer*\n * SourceTwitterTotal - *integer*\n * SourceGooglePlusTotal - *integer*\n * SourceOtherTotal - *integer*", "title": "Input and output parameters" } [/block] **Example** [block:code] { "codes": [ { "code": "using (var client = new ApiServiceClient())\n{\n\tclient.ClientCredentials.UserName.UserName = \"username\";\n\tclient.ClientCredentials.UserName.Password = \"password\";\n\n\tvar assignedToAddressBookOnly = true;\n\tvar select = 1000;\n\tvar skip = 0;\n\tvar surveys = client.GetSurveys(assignedToAddressBookOnly, select, skip);\n}", "language": "csharp" } ] } [/block]