Get merchant credit score

GET

/marketplace/data/merchant/{merchantId}/credit-score

Retrieve the most recent credit score for a merchant. You can only access scores for merchants who have granted consent to your marketplace.

Required scope: credit.score.read

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200OK

application/json

Credit score retrieved

Bodyapplication/json

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location '/marketplace/data/merchant/merchant_uuid/credit-score' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success Example

{
    "totalScore": 78,
    "riskTier": "B",
    "maxLendingCap": 930000,
    "eligiblePercentage": 30,
    "scoreBreakdown": {
        "salesPerformance": 28,
        "revenueConsistency": 13,
        "fulfillmentOps": 14,
        "payoutCashFlow": 15,
        "stabilityTenure": 8,
        "riskBehavior": 0
    },
    "lendingImplication": "Standard cap",
    "calculatedAt": "2026-01-29T08:15:30.000Z",
    "riskFlags": [],
    "recommendations": "Good credit profile. Standard lending terms apply."
}

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

Submit bulk merchant data

Integration health check