Match reports | Organizer API | API v2.0

Endpoints

GET /reports
Retrieve the match reports of a match.
POST /reports
Create a new match report in a match.
GET /reports/{id}
Retrieve a single match report of a match.
PATCH /reports/{id}
Update a match report in a match.
LegacyGET /tournaments/{tournament_id}/matches/{match_id}/reports
Retrieve the match reports of a match.
LegacyPOST /tournaments/{tournament_id}/matches/{match_id}/reports
Create a new match report in a match.
LegacyGET /tournaments/{tournament_id}/matches/{match_id}/reports/{id}
Retrieve a single match report of a match.
LegacyPATCH /tournaments/{tournament_id}/matches/{match_id}/reports/{id}
Update a match report in a match.

GET /reports

Returns the match reports of the given match, using various filters. Match reports are only available for "duel" type matches.

Resource URL

https://api.toornament.com/organizer/v2/reports

HTTP headers

X-Api-Key
string
API key of your application (see Authentication)
Authorization
string
Access token with organizer:result scope (see Authorization)
Range
string
A range of requested items using the reports unit. The size of the range can not exceed 50. (see Pagination)
Example: reports=0-49

Query Parameters

tournament_ids
array
Only return reports for the given list of tournaments.
Example: 378426939508809728,534138941862841533
match_ids
array
Only return reports for the given list of matchs.
Example: 2468971166855626795,436314459115419242
participant_ids
array
One or several participant ids involved in the reports to filter.
Example: 618965416546776434,618975467354349191
custom_user_identifiers
array
A list of external custom user identifiers.
Example: acme:account:1234,acme:account:1235
types
array
One or several report types to filter.
Example: report,dispute
is_closed
boolean
Whether to include scheduled matches.
Possible values: 0, 1

Request Body

This endpoint does not require a request body.

Response

[206] Match reports retrieved.

Example

[
    {
        "tournament_id": "534138941862841533",
        "match_id": "2468971166855626795",
        "id": "168954615761461654",
        "type": "report",
        "closed": false,
        "closed_at": "2015-12-31T00:00:00+00:00",
        "closed_author_id": "513743143408302391",
        "note": "A note on\ntwo lines\n",
        "participant_id": "375143143408309123",
        "user_id": "513743143408302391",
        "custom_user_identifier": "acme:account:1234",
        "report": {
            "opponents": [
                {
                    "score": 15,
                    "number": 1,
                    "result": "win",
                    "forfeit": false
                }
            ]
        },
        "proofs": [
            {
                "id": "506637910019156865"
            }
        ]
    }
]

Structure (collection)

tournament_id
string
The id of tournament.
Example: "534138941862841533"
match_id
string
The id of match.
Example: "2468971166855626795"
id
string
The id of the match report.
Example: "168954615761461654"
type
string
The type of the match report.
Possible values: dispute, report
closed
boolean
Whether the match report is closed.
Example: false
closed_at
string|null
The timestamp on which the match was played (a result was provided) in RFC 3339 format (combined date, time and utc offset).
Format: datetime
Example: "2015-12-31T00:00:00+00:00"
closed_author_id
string|null
The id of the organizer user that closed the report.
Example: "513743143408302391"
note
string|null
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
participant_id
string
The id of participant.
Example: "375143143408309123"
user_id
string|null
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
report
object
The report data.
- opponents
  array[object]
  List of the opponents involved in this match report.
  - score
    integer|null
    The score of the opponent.
    Example: 15
  - number
    integer
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Whether the opponent is forfeit.
    Example: false
proofs
array[object]
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"

POST /reports

Create a new match report in a match, there can only be one report per participant.Match reports are only available for "duel" type matches. Trying to POST a new report in a "ffa" type match will result in a 403 Error.

Resource URL

https://api.toornament.com/organizer/v2/reports

HTTP headers

X-Api-Key
string
API key of your application (see Authentication)
Authorization
string
Access token with organizer:result scope (see Authorization)

Query Parameters

This endpoint does not have any query parameters.

Request Body

Match report data.

Example

{
    "match_id": "2468971166855626795",
    "participant_id": "375143143408309123",
    "type": "report",
    "report": {
        "opponents": [
            {
                "score": 15,
                "number": 1,
                "result": "win",
                "forfeit": false
            }
        ]
    },
    "note": "A note on\ntwo lines\n",
    "user_id": "513743143408302391",
    "custom_user_identifier": "acme:account:1234",
    "proofs": [
        {
            "id": "506637910019156865"
        }
    ]
}

Structure (object)

match_id
string
The id of match.
Example: "2468971166855626795"
participant_id
string
The id of participant.
Example: "375143143408309123"
type
string
The type of the match report.
Possible values: dispute, report
report
object
The report data.
- opponents
  array[object]
  List of the opponents involved in this match report.
  - score
    integer|null
    The score of the opponent.
    Example: 15
  - number
    integer
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Whether the opponent is forfeit.
    Example: false
note
string|null
Optional
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
user_id
string|null
Optional
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
Optional
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
proofs
array[object]
Optional
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"

Response

[201] Success

Example

{
    "tournament_id": "534138941862841533",
    "match_id": "2468971166855626795",
    "id": "168954615761461654",
    "type": "report",
    "closed": false,
    "closed_at": "2015-12-31T00:00:00+00:00",
    "closed_author_id": "513743143408302391",
    "note": "A note on\ntwo lines\n",
    "participant_id": "375143143408309123",
    "user_id": "513743143408302391",
    "custom_user_identifier": "acme:account:1234",
    "report": {
        "opponents": [
            {
                "score": 15,
                "number": 1,
                "result": "win",
                "forfeit": false
            }
        ]
    },
    "proofs": [
        {
            "id": "506637910019156865"
        }
    ]
}

Structure (object)

tournament_id
string
The id of tournament.
Example: "534138941862841533"
match_id
string
The id of match.
Example: "2468971166855626795"
id
string
The id of the match report.
Example: "168954615761461654"
type
string
The type of the match report.
Possible values: dispute, report
closed
boolean
Whether the match report is closed.
Example: false
closed_at
string|null
The timestamp on which the match was played (a result was provided) in RFC 3339 format (combined date, time and utc offset).
Format: datetime
Example: "2015-12-31T00:00:00+00:00"
closed_author_id
string|null
The id of the organizer user that closed the report.
Example: "513743143408302391"
note
string|null
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
participant_id
string
The id of participant.
Example: "375143143408309123"
user_id
string|null
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
report
object
The report data.
- opponents
  array[object]
  List of the opponents involved in this match report.
  - score
    integer|null
    The score of the opponent.
    Example: 15
  - number
    integer
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Whether the opponent is forfeit.
    Example: false
proofs
array[object]
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"

GET /reports/{id}

Returns the match report with the given id. Match reports are only available for "duel" type matches.

Resource URL

https://api.toornament.com/organizer/v2/reports/{id}

HTTP headers

X-Api-Key
string
API key of your application (see Authentication)
Authorization
string
Access token with organizer:result scope (see Authorization)

Path parameters

id
string
The id of the match report to retrieve.

Query Parameters

This endpoint does not have any query parameters.

Request Body

This endpoint does not require a request body.

Response

[200] Match report retrieved.

Example

{
    "tournament_id": "534138941862841533",
    "match_id": "2468971166855626795",
    "id": "168954615761461654",
    "type": "report",
    "closed": false,
    "closed_at": "2015-12-31T00:00:00+00:00",
    "closed_author_id": "513743143408302391",
    "note": "A note on\ntwo lines\n",
    "participant_id": "375143143408309123",
    "user_id": "513743143408302391",
    "custom_user_identifier": "acme:account:1234",
    "report": {
        "opponents": [
            {
                "score": 15,
                "number": 1,
                "result": "win",
                "forfeit": false
            }
        ]
    },
    "proofs": [
        {
            "id": "506637910019156865"
        }
    ]
}

Structure (object)

tournament_id
string
The id of tournament.
Example: "534138941862841533"
match_id
string
The id of match.
Example: "2468971166855626795"
id
string
The id of the match report.
Example: "168954615761461654"
type
string
The type of the match report.
Possible values: dispute, report
closed
boolean
Whether the match report is closed.
Example: false
closed_at
string|null
The timestamp on which the match was played (a result was provided) in RFC 3339 format (combined date, time and utc offset).
Format: datetime
Example: "2015-12-31T00:00:00+00:00"
closed_author_id
string|null
The id of the organizer user that closed the report.
Example: "513743143408302391"
note
string|null
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
participant_id
string
The id of participant.
Example: "375143143408309123"
user_id
string|null
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
report
object
The report data.
- opponents
  array[object]
  List of the opponents involved in this match report.
  - score
    integer|null
    The score of the opponent.
    Example: 15
  - number
    integer
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Whether the opponent is forfeit.
    Example: false
proofs
array[object]
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"

PATCH /reports/{id}

Updates the match report with the given id. Match reports are only available for "duel" type matches.

Resource URL

https://api.toornament.com/organizer/v2/reports/{id}

HTTP headers

X-Api-Key
string
API key of your application (see Authentication)
Authorization
string
Access token with organizer:result scope (see Authorization)

Path parameters

id
string
The id of the match report to retrieve.

Query Parameters

This endpoint does not have any query parameters.

Request Body

Match report data.

Example

{
    "note": "A note on\ntwo lines\n",
    "user_id": "513743143408302391",
    "custom_user_identifier": "acme:account:1234",
    "report": {
        "opponents": [
            {
                "score": 15,
                "number": 1,
                "result": "win",
                "forfeit": false
            }
        ]
    },
    "proofs": [
        {
            "id": "506637910019156865"
        }
    ],
    "closed": false
}

Structure (object)

note
string|null
Optional
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
user_id
string|null
Optional
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
Optional
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
report
object
Optional
The report data.
- opponents
  array[object]
  Optional
  List of the opponents involved in this match report.
  - score
    integer|null
    Optional
    The score of the opponent.
    Example: 15
  - number
    integer
    Optional
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    Optional
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Optional
    Whether the opponent is forfeit.
    Example: false
proofs
array[object]
Optional
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"
closed
boolean
Optional
Whether the match report is closed.
Example: false

Response

[200] Match report update.

Example

{
    "tournament_id": "534138941862841533",
    "match_id": "2468971166855626795",
    "id": "168954615761461654",
    "type": "report",
    "closed": false,
    "closed_at": "2015-12-31T00:00:00+00:00",
    "closed_author_id": "513743143408302391",
    "note": "A note on\ntwo lines\n",
    "participant_id": "375143143408309123",
    "user_id": "513743143408302391",
    "custom_user_identifier": "acme:account:1234",
    "report": {
        "opponents": [
            {
                "score": 15,
                "number": 1,
                "result": "win",
                "forfeit": false
            }
        ]
    },
    "proofs": [
        {
            "id": "506637910019156865"
        }
    ]
}

Structure (object)

tournament_id
string
The id of tournament.
Example: "534138941862841533"
match_id
string
The id of match.
Example: "2468971166855626795"
id
string
The id of the match report.
Example: "168954615761461654"
type
string
The type of the match report.
Possible values: dispute, report
closed
boolean
Whether the match report is closed.
Example: false
closed_at
string|null
The timestamp on which the match was played (a result was provided) in RFC 3339 format (combined date, time and utc offset).
Format: datetime
Example: "2015-12-31T00:00:00+00:00"
closed_author_id
string|null
The id of the organizer user that closed the report.
Example: "513743143408302391"
note
string|null
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
participant_id
string
The id of participant.
Example: "375143143408309123"
user_id
string|null
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
report
object
The report data.
- opponents
  array[object]
  List of the opponents involved in this match report.
  - score
    integer|null
    The score of the opponent.
    Example: 15
  - number
    integer
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Whether the opponent is forfeit.
    Example: false
proofs
array[object]
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"

LegacyGET /tournaments/{tournament_id}/matches/{match_id}/reports

This endpoint is in legacy mode. Access will soon be deprecated. It is therefore advised to use another endpoint when possible.

Returns the match reports of the given match, using various filters. Match reports are only available for "duel" type matches.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/matches/{match_id}/reports

HTTP headers

X-Api-Key
string
API key of your application (see Authentication)
Authorization
string
Access token with organizer:result scope (see Authorization)
Range
string
A range of requested items using the reports unit. The size of the range can not exceed 50. (see Pagination)
Example: reports=0-49

Path parameters

tournament_id
string
The id of the tournament to retrieve.
match_id
string
The id of the match.

Query Parameters

participant_ids
array
One or several participant ids involved in the reports to filter.
Example: 618965416546776434,618975467354349191
types
array
One or several report types to filter.
Example: report,dispute
is_closed
boolean
Whether to include scheduled matches.
Possible values: 0, 1

Request Body

This endpoint does not require a request body.

Response

[206] Match reports retrieved.

Example

[
    {
        "id": "168954615761461654",
        "type": "report",
        "closed": false,
        "closed_at": "2015-12-31T00:00:00+00:00",
        "closed_author_id": "513743143408302391",
        "note": "A note on\ntwo lines\n",
        "participant_id": "375143143408309123",
        "user_id": "513743143408302391",
        "custom_user_identifier": "acme:account:1234",
        "report": {
            "opponents": [
                {
                    "score": 15,
                    "number": 1,
                    "result": "win",
                    "forfeit": false
                }
            ]
        },
        "proofs": [
            {
                "id": "506637910019156865"
            }
        ]
    }
]

Structure (collection)

id
string
The id of the match report.
Example: "168954615761461654"
type
string
The type of the match report.
Possible values: dispute, report
closed
boolean
Whether the match report is closed.
Example: false
closed_at
string|null
The timestamp on which the match was played (a result was provided) in RFC 3339 format (combined date, time and utc offset).
Format: datetime
Example: "2015-12-31T00:00:00+00:00"
closed_author_id
string|null
The id of the organizer user that closed the report.
Example: "513743143408302391"
note
string|null
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
participant_id
string
The id of participant.
Example: "375143143408309123"
user_id
string|null
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
report
object
The report data.
- opponents
  array[object]
  List of the opponents involved in this match report.
  - score
    integer|null
    The score of the opponent.
    Example: 15
  - number
    integer
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Whether the opponent is forfeit.
    Example: false
proofs
array[object]
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"

LegacyPOST /tournaments/{tournament_id}/matches/{match_id}/reports

This endpoint is in legacy mode. Access will soon be deprecated. It is therefore advised to use another endpoint when possible.

Create a new match report in a match, there can only be one report per participant.Match reports are only available for "duel" type matches. Trying to POST a new report in a "ffa" type match will result in a 403 Error.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/matches/{match_id}/reports

HTTP headers

X-Api-Key
string
API key of your application (see Authentication)
Authorization
string
Access token with organizer:result scope (see Authorization)

Path parameters

tournament_id
string
The id of the tournament to retrieve.
match_id
string
The id of the match.

Query Parameters

This endpoint does not have any query parameters.

Request Body

Match report data.

Example

{
    "participant_id": "375143143408309123",
    "type": "report",
    "report": {
        "opponents": [
            {
                "score": 15,
                "number": 1,
                "result": "win",
                "forfeit": false
            }
        ]
    },
    "note": "A note on\ntwo lines\n",
    "user_id": "513743143408302391",
    "custom_user_identifier": "acme:account:1234",
    "proofs": [
        {
            "id": "506637910019156865"
        }
    ]
}

Structure (object)

participant_id
string
The id of participant.
Example: "375143143408309123"
type
string
The type of the match report.
Possible values: dispute, report
report
object
The report data.
- opponents
  array[object]
  List of the opponents involved in this match report.
  - score
    integer|null
    The score of the opponent.
    Example: 15
  - number
    integer
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Whether the opponent is forfeit.
    Example: false
note
string|null
Optional
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
user_id
string|null
Optional
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
Optional
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
proofs
array[object]
Optional
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"

Response

[201] Success

Example

{
    "id": "168954615761461654",
    "type": "report",
    "closed": false,
    "closed_at": "2015-12-31T00:00:00+00:00",
    "closed_author_id": "513743143408302391",
    "note": "A note on\ntwo lines\n",
    "participant_id": "375143143408309123",
    "user_id": "513743143408302391",
    "custom_user_identifier": "acme:account:1234",
    "report": {
        "opponents": [
            {
                "score": 15,
                "number": 1,
                "result": "win",
                "forfeit": false
            }
        ]
    },
    "proofs": [
        {
            "id": "506637910019156865"
        }
    ]
}

Structure (object)

id
string
The id of the match report.
Example: "168954615761461654"
type
string
The type of the match report.
Possible values: dispute, report
closed
boolean
Whether the match report is closed.
Example: false
closed_at
string|null
The timestamp on which the match was played (a result was provided) in RFC 3339 format (combined date, time and utc offset).
Format: datetime
Example: "2015-12-31T00:00:00+00:00"
closed_author_id
string|null
The id of the organizer user that closed the report.
Example: "513743143408302391"
note
string|null
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
participant_id
string
The id of participant.
Example: "375143143408309123"
user_id
string|null
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
report
object
The report data.
- opponents
  array[object]
  List of the opponents involved in this match report.
  - score
    integer|null
    The score of the opponent.
    Example: 15
  - number
    integer
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Whether the opponent is forfeit.
    Example: false
proofs
array[object]
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"

LegacyGET /tournaments/{tournament_id}/matches/{match_id}/reports/{id}

This endpoint is in legacy mode. Access will soon be deprecated. It is therefore advised to use another endpoint when possible.

Returns the match report with the given id. Match reports are only available for "duel" type matches.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/matches/{match_id}/reports/{id}

HTTP headers

X-Api-Key
string
API key of your application (see Authentication)
Authorization
string
Access token with organizer:result scope (see Authorization)

Path parameters

tournament_id
string
The id of the tournament to retrieve.
match_id
string
The id of the match.
id
string
The id of the match report to retrieve.

Query Parameters

This endpoint does not have any query parameters.

Request Body

This endpoint does not require a request body.

Response

[200] Match report retrieved.

Example

{
    "id": "168954615761461654",
    "type": "report",
    "closed": false,
    "closed_at": "2015-12-31T00:00:00+00:00",
    "closed_author_id": "513743143408302391",
    "note": "A note on\ntwo lines\n",
    "participant_id": "375143143408309123",
    "user_id": "513743143408302391",
    "custom_user_identifier": "acme:account:1234",
    "report": {
        "opponents": [
            {
                "score": 15,
                "number": 1,
                "result": "win",
                "forfeit": false
            }
        ]
    },
    "proofs": [
        {
            "id": "506637910019156865"
        }
    ]
}

Structure (object)

id
string
The id of the match report.
Example: "168954615761461654"
type
string
The type of the match report.
Possible values: dispute, report
closed
boolean
Whether the match report is closed.
Example: false
closed_at
string|null
The timestamp on which the match was played (a result was provided) in RFC 3339 format (combined date, time and utc offset).
Format: datetime
Example: "2015-12-31T00:00:00+00:00"
closed_author_id
string|null
The id of the organizer user that closed the report.
Example: "513743143408302391"
note
string|null
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
participant_id
string
The id of participant.
Example: "375143143408309123"
user_id
string|null
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
report
object
The report data.
- opponents
  array[object]
  List of the opponents involved in this match report.
  - score
    integer|null
    The score of the opponent.
    Example: 15
  - number
    integer
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Whether the opponent is forfeit.
    Example: false
proofs
array[object]
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"

LegacyPATCH /tournaments/{tournament_id}/matches/{match_id}/reports/{id}

This endpoint is in legacy mode. Access will soon be deprecated. It is therefore advised to use another endpoint when possible.

Updates the match report with the given id. Match reports are only available for "duel" type matches.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/matches/{match_id}/reports/{id}

HTTP headers

X-Api-Key
string
API key of your application (see Authentication)
Authorization
string
Access token with organizer:result scope (see Authorization)

Path parameters

tournament_id
string
The id of the tournament to retrieve.
match_id
string
The id of the match.
id
string
The id of the match report to retrieve.

Query Parameters

This endpoint does not have any query parameters.

Request Body

Match report data.

Example

{
    "note": "A note on\ntwo lines\n",
    "user_id": "513743143408302391",
    "custom_user_identifier": "acme:account:1234",
    "report": {
        "opponents": [
            {
                "score": 15,
                "number": 1,
                "result": "win",
                "forfeit": false
            }
        ]
    },
    "proofs": [
        {
            "id": "506637910019156865"
        }
    ],
    "closed": false
}

Structure (object)

note
string|null
Optional
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
user_id
string|null
Optional
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
Optional
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
report
object
Optional
The report data.
- opponents
  array[object]
  Optional
  List of the opponents involved in this match report.
  - score
    integer|null
    Optional
    The score of the opponent.
    Example: 15
  - number
    integer
    Optional
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    Optional
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Optional
    Whether the opponent is forfeit.
    Example: false
proofs
array[object]
Optional
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"
closed
boolean
Optional
Whether the match report is closed.
Example: false

Response

[200] Match report update.

Example

{
    "id": "168954615761461654",
    "type": "report",
    "closed": false,
    "closed_at": "2015-12-31T00:00:00+00:00",
    "closed_author_id": "513743143408302391",
    "note": "A note on\ntwo lines\n",
    "participant_id": "375143143408309123",
    "user_id": "513743143408302391",
    "custom_user_identifier": "acme:account:1234",
    "report": {
        "opponents": [
            {
                "score": 15,
                "number": 1,
                "result": "win",
                "forfeit": false
            }
        ]
    },
    "proofs": [
        {
            "id": "506637910019156865"
        }
    ]
}

Structure (object)

id
string
The id of the match report.
Example: "168954615761461654"
type
string
The type of the match report.
Possible values: dispute, report
closed
boolean
Whether the match report is closed.
Example: false
closed_at
string|null
The timestamp on which the match was played (a result was provided) in RFC 3339 format (combined date, time and utc offset).
Format: datetime
Example: "2015-12-31T00:00:00+00:00"
closed_author_id
string|null
The id of the organizer user that closed the report.
Example: "513743143408302391"
note
string|null
Private note of a report, only visible to the organizers.
Max. length: 1,000 characters
Example: "A note on\ntwo lines\n"
participant_id
string
The id of participant.
Example: "375143143408309123"
user_id
string|null
The id of user.
Example: "513743143408302391"
custom_user_identifier
string|null
An external custom user identifier. Use the format that suits your needs.
Max. length: 100 characters
Example: "acme:account:1234"
report
object
The report data.
- opponents
  array[object]
  List of the opponents involved in this match report.
  - score
    integer|null
    The score of the opponent.
    Example: 15
  - number
    integer
    The match opponent number (a relative identifier within a match).
    Example: 1
  - result
    string
    The match result of the opponent.
    Possible values: win, draw, loss
  - forfeit
    boolean
    Whether the opponent is forfeit.
    Example: false
proofs
array[object]
A list of match proof files
- id
  string
  The unique identifier of a file (with context "match_report_proof"), that can be used in other APIs.
  Example: "506637910019156865"