Skip to main content
GET
/
v1
/
portal
/
match
/
status
curl https://portal-api.7331.org/v1/portal/match/status \
  -b "psession=YOUR_SESSION"

{
  "state": "searching",
  "interests": ["gaming", "music"],
  "expires_at": "2026-05-06T18:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.7331.org/llms.txt

Use this file to discover all available pages before exploring further.

Returns the user’s current matchmaking state. This is a pure read — it has no side effects on the queue TTL. Queue entries are kept alive by socket presence events, not by polling this endpoint. Clients should poll this endpoint while searching to detect when state transitions to matched.

​
Response

​
state
string
required
One of idle, searching, matched.
​
interests
string[]
Interest tags the user is currently queued on — populated when state is searching.
​
token
string
Bearer credential for joining the matched chat over Socket.IO — populated when state is matched.Treat as a secret on the client. Do not log it, persist it to non-volatile storage, or include it in error reports / crash dumps. Anyone holding this value can join the matched 1-on-1 chat.
​
expires_at
string
ISO-8601 timestamp — populated when state is searching (queue TTL deadline) or matched (24h chat expiry).
curl https://portal-api.7331.org/v1/portal/match/status \
  -b "psession=YOUR_SESSION"

{
  "state": "searching",
  "interests": ["gaming", "music"],
  "expires_at": "2026-05-06T18:00:00Z"
}