Skip to content

Overview

The API is available at https://api.bflist.io/.

Error messages#

The API always returns a JSON array of errors. Even when requesting a plain text property such as /players/:name/score, you will receive a JSON response in case of an error.

{
    "errors": [
        "Player not found/not online"
    ]
}

You can force plain text errors by setting plainerr to 1 via a query parameter. For example: /players/:name/score?plainerr=1 will return any errors as plain text rather than JSON.