Last updated on December 9, 2025

Matchmaking V2 Notification Events 0.1.0 documentation

• Protobuf File Spec: matchmakingv2.proto

Published Messages (freeformUserNotificationRequest)

The service publishes one of these messages below.

freeformUserNotification

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

Published Messages (mpv2SessionHistory)

The service publishes one of these messages below.

MatchmakingEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MatchmakingStartedEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MatchmakingTicketExpiredEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MatchmakingTicketCanceledEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MatchmakingTicketRejectedEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MatchmakingTicketFoundEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MatchFoundEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

BackfillFoundEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

BackfillProposalSentEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

BackfillProposalAcceptedEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

BackfillProposalRejectedEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

BackfillProposalExpiredEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

BackfillTicketExpiredEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MatchHistoryEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MatchmakingSessionTickEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MatchmakingTicketReturnedToPoolEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MatchmakingTickEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MetricCanceledMatchmakingTicketEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MetricCreatedMatchmakingTicketEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MetricExpiredMatchmakingTicketEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MetricMatchMatchmakingEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

MetricMatchMatchmakingTicketEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

PartialBackfillProposalRejectedEvent

Contains fields from event and the following payload.

Example value

{
  "payload": {
    "userIds": [
      "string"
    ],
    "namespace": "string",
    "topicName": "string",
    "message": "string"
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "traceId": "string",
  "spanContext": "string"
}

payload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-

Schemas

event

Name	Type	Description
id	string	-
version	integer	-
name	string	-
namespace	string	-
parentNamespace	string	-
timestamp	string (date-time)	-
traceId	string	-
spanContext	string	-

notificationPayload

Name	Type	Description
userIds	array	-
namespace	string	-
topicName	string	-
message	string	-