Get current match status

Designing

Staging

https://staging.syncode.anggita.org/api

GET

/matchmaking/request

Matchmaking

Returns the current matchmaking status. When a match is found, includes opponent details and an accept/decline deadline (30s timeout). Client should poll every 2-3 seconds.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Responses

🟢200OK

application/json

Match status

Body

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://staging.syncode.anggita.org/api/matchmaking/request' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6",
    "status": "searching",
    "match": {
        "matchId": "685569fd-95e6-4335-9aa5-fdd22382bd9e",
        "opponent": {
            "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
            "username": "string",
            "displayName": "string",
            "avatarUrl": "string"
        },
        "assignedRole": "host",
        "expiresAt": "2019-08-24T14:15:22.123Z"
    },
    "createdAt": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-03-11 21:12:01

Cancel matchmaking

Accept a proposed match