Games

Get my ongoing games

Changed on

Get the ongoing games of the current user. Real-time and correspondence games are included. The most urgent games are listed first.

get/api/account/playing

Request

  • Base URL
    https://lichess.org
  • URL
    https://lichess.org/api/account/playing
  • Auth
    OAuth 2
    Authorization code: https://lichess.org/oauth
    Token URL: https://lichess.org/api/token

Query parameters

nbinteger

Max number of games to fetch

Response

The ongoing games of the logged in user.

nbMyTurninteger required

Number of games where it is my turn to play

Changes

    • breaking

      added subschema #1: Player subschema #2: Anonymous opponent subschema #3: AI opponent to the // response property oneOf list for the response status

    • breaking

      the // response's property type changed from object to no type for status

    • breaking

      the // response's property type changed from string to object for status

    • breaking

      removed the required property /// from the response with the status

    • breaking

      removed the required property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • info

      removed the aborted enum value from the // response property for the response status

    • info

      removed the cheat enum value from the // response property for the response status

    • info

      removed the created enum value from the // response property for the response status

    • info

      removed the draw enum value from the // response property for the response status

    • info

      removed the insufficientMaterialClaim enum value from the // response property for the response status

    • info

      removed the mate enum value from the // response property for the response status

    • info

      removed the noStart enum value from the // response property for the response status

    • info

      removed the outoftime enum value from the // response property for the response status

    • info

      removed the resign enum value from the // response property for the response status

    • info

      removed the stalemate enum value from the // response property for the response status

    • info

      removed the started enum value from the // response property for the response status

    • info

      removed the timeout enum value from the // response property for the response status

    • info

      removed the unknownFinish enum value from the // response property for the response status

    • info

      removed the variantEnd enum value from the // response property for the response status

    • info

      added the required property // to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status