Leads API v1.0.0 eBay Docs

The Leads API lets sellers return leads generated by their Classified Ad and includes any contact information that prospective buyers have submitted. A seller can retrieve leads for items listed under their own seller account for a specified marketplace optionally filtered by specified search criteria. Use this resource to retrieve sales-lead information for lead-generating classified ad listings.

ClassifiedLead

GetAllClassifiedLeads eBay Docs

GET

/classified_lead

This method retrieves leads for all of the seller's active classified ad listings. Optionally, just those matching specified filter criteria can be returned.

use Rat\eBaySDK\API\LeadsAPI\ClassifiedLead\GetAllClassifiedLeads;
use Rat\eBaySDK\Client;

$client = app(Client::class);
$request = new GetAllClassifiedLeads(
    startTime: (string) $startTime = null,
    endTime: (string) $endTime = null,
    includeMessages: (bool) $includeMessages = false,
    status: (string) $status = null,
);
$response = $client->execute($request);

GetAllClassifiedLeadsByItemId eBay Docs

GET

/classified_lead/{itemId}

This method returns a seller account's leads generated by the specified classified ad, and includes any contact information that prospective buyers have submitted. Optionally, just those matching specified filter criteria can be returned.

use Rat\eBaySDK\API\LeadsAPI\ClassifiedLead\GetAllClassifiedLeadsByItemId;
use Rat\eBaySDK\Client;

$client = app(Client::class);
$request = new GetAllClassifiedLeadsByItemId(
    itemId: (string) $itemId,
    startTime: (string) $startTime = null,
    endTime: (string) $endTime = null,
    includeMessages: (bool) $includeMessages = false,
    status: (string) $status = null,
);
$response = $client->execute($request);