App Status Image/Badge API

Japanese translation unavailable

This page has not been translated into Japanese yet - we apologise for the inconvenience! If you’re interested in helping us out, feel free to translate any article in the jp folder of the DevCenter repository and open a PR!

このページは日本語への翻訳がまだ完了しておりません。ご不便をおかけして申し訳ございません! もしお手伝いできる方がいらっしゃれば、ご自由にjpフォルダの記事を日本語に訳していただき、PRを開いてください

With the Status Image API token, you can get an embeddable SVG badge image, a JSON message reflecting the status of the app, or a specific branch of the app.

  1. Open your App on and click the badge image right next to the app’s name.


  2. In the Status image popup, you can optionally set a branch, and get copy-paste-ready Embed codes for the SVG image.

    An example for SVG URL:

    To get the JSON equivalent of the status image, simply replace the .svg in the Embed URL with .json.

    An example for JSON URL:


The STATUS-IMAGE-API-TOKEN is a special token which can only be used for calling this endpoint (you can find this token in the Status image popup). No other information can be retrieved with this token, and it’s not the same as the API Token which you can find on the Code tab!

JSON response

The JSON response returns a very simple JSON object:



HTTP Codes and Errors

If the APP-ID and the STATUS-IMAGE-API-TOKEN parameters are correct, and they identify an existing app, a 200 HTTP code is returned along with the JSON response, even if the branch parameter points to a non-existing branch (the JSON response in this case will be {"status": "unknown"} with a 200 HTTP code).

If the APP-ID or the STATUS-IMAGE-API-TOKEN (or both) is not correct, you’ll get a HTTP 403 code with an empty response body.