Submit bulk merchant data

POST

/marketplace/data/merchants/bulk

Submit data for multiple merchants in a single request. Maximum 1000 merchants per batch. For single-merchant OAuth tokens, the endpoint filters to only include data for the consented merchant.

Required scope: data.share.sales

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Bulk data processed

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location '/marketplace/data/merchants/bulk' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "merchants": [
        {
            "merchantIdentity": {
                "merchantId": "merchant_001",
                "businessName": "Yakoyo Foods Ltd",
                "businessType": "REGISTERED_BUSINESS",
                "marketplaceOnboardingDate": "2023-06-15T00:00:00.000Z",
                "verificationStatus": true,
                "location": "Lagos, Nigeria",
                "country": "Nigeria",
                "category": "food_beverages"
            },
            "salesPerformance": {
                "gmv30Days": 2500000,
                "gmv90Days": 8200000,
                "gmv180Days": 18500000,
                "avgMonthlySales": 3100000,
                "orderCount": 456,
                "avgOrderValue": 6800,
                "salesGrowthRate": 15.5
            },
            "revenueConsistency": {
                "monthlySalesVariance": 12.5,
                "zeroSalesMonths": 0,
                "longestSalesStreak": 18,
                "revenueConcentration": 35.2
            },
            "fulfillmentMetrics": {
                "fulfillmentRate": 97.8,
                "cancellationRate": 2.1,
                "refundRate": 1.5,
                "refundAmount": 45000,
                "disputeRate": 0.8,
                "lateDeliveryRate": 3.2
            },
            "payoutCashFlow": {
                "payoutFrequency": "WEEKLY",
                "avgPayoutValue": 775000,
                "failedPayouts": 0,
                "walletBalanceUsage": 125000,
                "settlementDelays": 0
            },
            "platformDependency": {
                "topProductGmvPercentage": 28.5,
                "topCustomerPercentage": 12.3
            },
            "behavioralRisk": {
                "accountSuspensions": 0,
                "policyViolationsSeverity": null,
                "hasFraudFlags": false,
                "hasSuddenGmvSpikes": false,
                "hasLinkedAccounts": false
            }
        }
    ],
    "marketplaceId": "your_marketplace_id",
    "batchTimestamp": "2026-01-29T08:00:00.000Z",
    "batchId": "batch_001"
}'

Response Example

200 - Success Example

{
    "success": true,
    "message": "Bulk data processed",
    "totalProcessed": 50,
    "successfullyProcessed": 48,
    "failed": 2,
    "errors": [
        {
            "field": "salesPerformance.gmv30Days",
            "error": "Must be a non-negative number",
            "merchantId": "merchant_42"
        }
    ],
    "processedMerchantIds": [
        "merchant_1",
        "merchant_2"
    ],
    "processedAt": "2026-01-29T08:15:30.000Z"
}

Modified at 2026-04-08 17:24:40

Submit single merchant data

Get merchant credit score