Search proposals

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.

Email

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: - True - False

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 = "[email protected]";
$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.

Last updated

Was this helpful?