Connections Endpoints

List Connections

Retrieve the status of Amazon SP-API and PPC (Advertising) API connections for the selected account.

GET /connections/list

Query Parameters: An account selection parameter is required.

Example Request:

curl -X GET "https://app.sellerlegend.com/api/connections/list?account_title=My Store US" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

Response:

[
  {
    "type": "SP-API",
    "marketplace": "amazon.com",
    "seller_id": "A1234567890",
    "status": "active",
    "last_sync": "2025-01-15T12:00:00Z"
  },
  {
    "type": "PPC",
    "marketplace": "amazon.com",
    "profile_id": "1234567890",
    "status": "active",
    "last_sync": "2025-01-15T11:45:00Z"
  }
]

Response Fields:

Field	Type	Description
type	string	Connection type: SP-API or PPC
marketplace	string	Amazon marketplace domain
seller_id	string	Amazon Seller ID (SP-API connections)
profile_id	string	Amazon Advertising profile ID (PPC connections)
status	string	Connection status: active, inactive, or error
last_sync	string	ISO 8601 timestamp of the last successful data sync

Python SDK:

from sellerlegend_api import SellerLegendClient

client = SellerLegendClient(access_token="YOUR_ACCESS_TOKEN")

connections = client.connections.list(
    account_title="My Store US"
)

for connection in connections['data']:
    print(f"Type: {connection['type']} | Status: {connection['status']}")
    print(f"Last Sync: {connection['last_sync']}")