Search proposals
Overview
Use the searchProposals method via SOAP APIv6 to find a specific proposal or quote.
Request parameters
Parameters | Type | Required/Optional | Description |
---|---|---|---|
sessionId | String | Required | Unique 2Checkout session ID code. |
Name | String | Optional | Proposal name. |
String | Optional | The bill to or sell to email. | |
CreatedBy | String | Optional | The unique external system user identifier. |
ModifiedBy | String | Optional | The unique external system user identifier. |
Source | String | Optional | The source from where the proposal was created. |
CreatedAfter | String | Optional | The UTC date and time in ISO 8601 format. |
CreatedBefore | String | Optional | The UTC date and time in ISO 8601 format. |
ModifiedAfter | String | Optional | The UTC date and time in ISO 8601 format. |
ModifiedBefore | String | Optional | The UTC date and time in ISO 8601 format. |
Locked | Boolean | Optional |
Retrieve proposals that are locked or not. Possible values:
|
Offset | Integer | Required | The offset at which the proposals should be returned. Default value: 0. |
Limit | Integer | Required | The maximum number of proposals to return. Default value: 10. |
LinkId | String | Optional | The link id for any status. |
Request sample
<?php require ('PATH_TO_AUTH'); $searchParameters = new stdClass(); $searchParameters->Name = "My Proposal Name"; $searchParameters->Email = "example@email.com"; $searchParameters->CreatedBy = "createUser"; $searchParameters->ModifiedBy = "modifyUser"; $searchParameters->Source = "MERCHANT_API"; $searchParameters->CreatedAfter = "2020-01-01T00:00:00+00:00"; $searchParameters->CreatedBefore = "2020-12-31T23:59:59+00:00"; $searchParameters->ModifiedAfter = "2020-01-01T00:00:00+00:00"; $searchParameters->ModifiedBefore = "2020-12-31T23:59:59+00:00"; $searchParameters->Locked = false; $searchParameters->Offset = 0; $searchParameters->Limit = 10; try { $results = $soapClient->searchProposals($sessionID, $searchParameters); echo "Search results: </br>", var_dump($results); } catch (SoapFault $e) { echo "Could not search proposals: " . $e->getMessage(); exit; }
Response
The searchProposals call via SOAP APIv6 returns a list of proposal objects.