Search proposals
Last updated: 08-Jul-2020
Rate this article:
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.
Rate this article:
