Connections List
GET {{SL_BASE_URL}}/api/connections/list
This endpoint provides list of Amazon connections that exist between SellerLegend and the Amazon Selling Partner API and the Amazon Advertising API. With connection token status and details about all connected marketplaces.
The response contains:
- account_title -- The title of account on SellerLegend
- seller_id -- The amazon registered SellerID
- region -- The marketplace's region
- sp -- status -- The status of Amazon selling partner API
- sp -- lastconnectedat -- Timestamp when sp_api token was updated
- sp -- lastrefreshedat -- Timestamp when sp_api token was refreshed
- sp -- brandanalyticsaccess -- Does account has access to salestrafficreport, true | false
- ppc -- status -- The status of Amazon advertising partner API
- ppc -- lastconnectedat -- Timestamp when ppc token updated
- ppc -- lastrefreshedat -- Timestamp when ppc token was refreshed
- marketplaces -- A list of all marketplaces with accounttitle, marketplaceid, status, onboardingprogress (if account is still in onboarding phase) or accountupdates (if account is onboarded)
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"status":"Success","code":200,"message":"Connections List","path":"api/connections/list","connections":[{"account_title":"MyAccountTitle (Europe)","seller_id":"\u003cSELLER-ID\u003e","region":"Europe","sp":{"status":"CONNECTED","last_connected_at":"2023-03-26T06:58:53Z","last_refreshed_at":"2023-04-10T02:10:23Z","brand_analytics_access":true},"ppc":{"status":"CONNECTED","last_connected_at":"2023-03-26T04:25:53Z","last_refreshed_at":"2023-04-10T02:10:23Z"},"marketplaces":{"DE":{"account_title":"MyAccountTitle 2 (DE)","country":"DE","marketplace_id":"A1RKKUPIHCS9HS","status":"ONBOARDED","account_updates":{"orders_updated_at":"2023-04-01T00:10:53Z","products_updated_at":"2023-04-02T01:30:20Z","finances_updated_at":"2023-04-02T02:00:24Z","inventory_updated_at":"2023-04-02T03:50:43Z","ppc_updated_at":"2023-04-06T07:00:23Z"}},"ES":{"status":"NOT_STARTED_BY_USER"}}},{"account_title":"MyAccountTitle 2 (Europe)","seller_id":"\u003cSELLER-ID\u003e","region":"Europe","sp":{"status":"CONNECTED","last_connected_at":"2023-03-26T06:58:53Z","last_refreshed_at":"2023-04-10T02:10:23Z","brand_analytics_access":false},"ppc":{"status":"CONNECTED","last_connected_at":"2021-11-02T06:58:53Z","last_refreshed_at":"2021-11-10T06:10:23Z"},"marketplaces":{"DE":{"status":"NOT_STARTED_BY_USER"},"ES":{"account_title":"MyAccountTitle 2 (ES)","country":"ES","marketplace_id":"A1RKKUPIHCS9HS","status":"ONBOARDING_3_MONTHS","onboarding_progress":{"orders":"0%","inventory":"0%","finances":"0%","bsr":"0%","product_history":"0%"}}}},{"account_title":"MyAccountTitle 3 (US)","seller_id":"\u003cSELLER-ID\u003e","region":"North America","sp":{"status":"NOT_CONNECTED"},"ppc":{"status":"NOT_CONNECTED"},"marketplaces":[]}]}