Get match prediction

Developing

GET

/v1/match-predictions/{matchPredictionId}

Fetch one match prediction by id.

Auth: Bearer API key with matchPredictions permission.
Cross-community isolation: unknown-id and cross-community requests return the SAME 404 shape — never leaks existence.
Rate limit: standard per-community limit — 429 RATE_LIMITED with Retry-After on breach.
Freeze: while MATCH_PREDICTION_FROZEN=true, returns 503 MATCH_PREDICTION_FROZEN.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200Success

application/json

Match prediction retrieved.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not found

🟠429Rate limited

🔴503Frozen

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.returning.ai/v1/match-predictions/mp_01abc' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
  "meta": {
    "status": "success",
    "statusCode": 200,
    "code": "MATCH_PREDICTION_RETRIEVED",
    "requestId": "req_01abc",
    "timestamp": "2026-08-07T12:00:00.000Z"
  },
  "message": "Match prediction retrieved.",
  "data": {
    "id": "mp_01abc",
    "status": "open",
    "version": 3
  }
}

Modified at 2026-09-25 08:29:20

List match predictions

Patch match prediction