Get available marketplaces

GET

/api/merchants/platforms

Retrieves all available marketplaces/platforms with their connection status for the authenticated merchant.

Use Cases:

Display a list of available integrations in the merchant dashboard

Show which platforms the merchant is currently connected to

Help merchants discover new platforms to integrate with

Connection Status Values:

NOT_CONNECTED - Platform available but not connected

PENDING - Connection in progress (OAuth flow started)

CONNECTED - Successfully connected and syncing data

DISCONNECTED - Previously connected but now revoked

FAILED - Connection attempt failed

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Responses

🟢200

application/json

List of marketplaces with connection status retrieved successfully

Body

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.dev.opensylo.com/api/merchants/platforms' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "platforms": [
        {
            "platform": {
                "id": "chowdeck",
                "name": "chowdeck",
                "displayName": "Chowdeck",
                "description": "Food delivery platform that helps restaurants sell meals online and reach more customers.",
                "type": "FOOD_DELIVERY",
                "logo": "/logos/chowdeck.png",
                "website": "https://chowdeck.com",
                "status": "PENDING",
                "features": [
                    "Online food ordering",
                    "Delivery management",
                    "Real-time order tracking"
                ],
                "requirements": [
                    "Valid business registration",
                    "Food service license",
                    "Bank account"
                ]
            },
            "connectionStatus": "NOT_CONNECTED",
            "connectedAt": "2024-01-15T10:00:00.000Z",
            "lastSyncAt": "2024-01-20T15:30:00.000Z",
            "connectionId": "conn_abc123",
            "metadata": {
                "storeName": "Yakoyo Lekki Store",
                "storeId": "store_456",
                "accountEmail": "store@example.com"
            }
        }
    ],
    "totalPlatforms": 8,
    "connectedCount": 2,
    "availableCount": 6
}

Modified at 2025-12-30 08:04:15

HealthController_ping

Get marketplace catalog