Seller Details

Overview

The Seller Details API allows you to retrieve and manage seller account information. Sellers represent merchant accounts in the marketplace, each with unique identifiers, profile information, and account settings.

In SellerCenter, sellers can be managed through various endpoints:

• Current seller operations: Get and update information for the currently authenticated seller
• Seller listing: List and search sellers with filtering options
• Seller lookup: Find sellers by ID or external source ID
• Seller creation: Create new seller accounts (admin only)

Important: Note that changes in some fields in seller profile require approval. Endpoints return approved values. If a field requires QC (e.g., "Account Number") and was changed from approved value A to B but not yet approved by admins, the endpoint will return A as the value.

Get Current Seller Details

GET /v2/seller

Summary: Fetch currently logged in seller details

Description: Fetch current seller data. Note that changes in some fields in seller profile require approval. This endpoint returns approved values. In more details, it means the following: if there is a field that requires QC (e.g. "Account Number"), and it was changed from the approved value A to B and this change was not yet approved by admins, then this endpoint will return A as the value of this field.

A seller might be delisted due to multiple reasons. The following delist reasons are defined:

• USER_DEFINED (id = 1)
• HOLIDAY_MODE (id = 2)
• DAILY_ORDER_LIMIT (id = 4)
• PENDING_ORDER_LIMIT (id = 8)
• PENDING_TO_SHIPPED_ORDER_LIMIT (id = 16)

Update Seller Details

PATCH /v2/seller

Summary: Update seller details

Description: Update seller details for the currently authenticated seller. This endpoint allows you to modify seller information such as email, company name, and other profile fields.

Note: Some fields may require QC approval before changes take effect. Use the profile diff endpoint to check which fields have pending changes.

Get All Sellers

GET /v2/sellers

Summary: Get all sellers

Description: List and filter sellers. Note that changes in some fields in seller profile require approval. This endpoint returns approved values. In more details it means following: if there is field which requires QC, let's say "Account Number", and it was changed from approved value A to B and this change was not yet approved by admins, then this endpoint will return A as value of this field.

Parameters:

• sellerSrcId (query, optional): External ID of the seller from Shop System
• ids[] (query, optional): IDs of sellers to search
• uuids[] (query, optional): UUIDs of sellers to search
• shortCodes[] (query, optional): ShortCodes of sellers to search
• name (query, optional): Name or part of the name of the seller
• onlyActive (query, optional): When set to truthy value, only sellers that were ever synced with the shop system and with active account status will be returned. Temporary delisted sellers will be also returned. Sellers reached order limit will be also returned. Sellers with HolidayMode active will be also returned. Sellers who has not yet approved changes in their profile (but were approved and synced at some point previously) will be also returned. When not set or set to falsy value, all sellers will be returned (no filtering by active status will be applied)
• limit (query, optional): The maximum number of items to return
• offset (query, optional): The number of items to skip before starting to return results

Create Seller

POST /v2/sellers

Summary: Create a new seller

Description: Create a new seller by providing the necessary information. This action requires admin privileges.

Note: This endpoint is restricted to users with admin permissions. Regular sellers cannot create new seller accounts.

Get Seller By ID

GET /v2/sellers/{sellerId}

Summary: Get seller by ID

Description: Fetch a seller by a provided id. You need to either belong to the seller or have permission to see all sellers in order to get the data. Note that changes in some fields in seller profile require approval. This endpoint returns approved values. In more details it means following: if there is field which requires QC, let's say "Account Number", and it was changed from approved value A to B and this change was not yet approved by admins, then this endpoint will return A as value of this field.

Parameters:

• sellerId (path, required): Numeric ID of the seller

Get Seller By External Source ID

GET /v2/sellers/external/{sellerSrcId}

Summary: Get seller by external source ID

Description: Fetch a seller by a provided src id. You need to either belong to the seller or have permission to see all sellers in order to get the data. Note that changes in some fields in seller profile require approval. This endpoint returns approved values. In more details it means following: if there is field which requires QC, let's say "Account Number", and it was changed from approved value A to B and this change was not yet approved by admins, then this endpoint will return A as value of this field.

Parameters:

• sellerSrcId (path, required): External ID of the seller from Shop System

Note: This endpoint is useful when you have the external source ID from your shop system and need to find the corresponding seller in SellerCenter.