Get seller lead's data by ID
Marketplace operators may call this endpoint to retrieve information about a specific seller invited to the Seller Portal, by searching through their seller lead ID. To retrieve the chosen seller's sellerLeadId, marketplace operators can use the List Sellers endpoint's response. Each seller listed includes the following information:
-
id
-
createdAt
-
status
-
isConnected
-
sellerEmail
-
sellerName
-
salesChannel
-
email.
Permissions
Any user or API key must have at least one of the appropriate License Manager resources to be able to successfully run this request. Otherwise they will receive a status code 403 error. These are the applicable resources for this endpoint:
| Product | Category | Resource |
|---|---|---|
| Seller Register | Seller Administration | View Seller |
You can create a custom role with that resource or use one of the following predefined roles:
| Role | Resource |
|---|---|
| Seller manager | View Seller |
❗ Assigning a predefined role to users or application keys usually grants permission to multiple License Manager resources. If some of these permissions are not necessary, consider creating a custom role instead. For more information regarding security, see Best practices for using application keys.
Path parameters
Name of the VTEX account that belongs to the marketplace. The notification will be posted into this account.
Environment to use. Used as part of the URL.
A string that identifies the seller in the marketplace. This ID must be created by the marketplace and informed to the seller before the integration is built.
Headers
HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.
Type of the content being sent.
Response
OK