Skip to content
Evgeny Slavnov edited this page Dec 26, 2018 · 11 revisions

PHILIPS TV (2016+) UNOFFICIAL API REFERENCE

The TV's API is roughly based on JointSpace with a current version of 6.2. The only available official documentation that I was able to find is for JointSpace version 1, which is incredibly outdated.

Since no official API documentation is available, I've decided to collect and document to the best of my knowledge all endpoints that are working in API version 6+ (Philips TVs 2016-2018). This API reference is based on:

  • Official JointSpace documentation
  • Community endpoints (various endpoints discovered by the community over the years)
  • Endpoints discovered by using a man-in-the-middle attack on an iPhone running an official Philips TV remote app (this finally allowed to discover an endpoint responsible for toggling 'Ambilight + Hue' mode among other things)

All endpoints in API reference are tested and fully working unless explicitly marked otherwise. Some channel endpoints are missing since I can not test them until January 2018. Any comments, new endpoints and fixes to the API reference are incredibly welcome.

Send requests with the tool's get or post commands or use cURL:

curl -X GET --digest --insecure -u %username%:%password% https://%ip_address%:1926/6/%endpoint%

curl -X POST --digest --insecure -u %username%:%password% https://%ip_address%:1926/6/%endpoint% -d '%body%'

TABLE OF CONTENTS

        Ambilight:

  1. Ambilight power (GET)

  2. Ambilight power (POST)

  3. Ambilight supported styles (GET)

  4. Ambilight config (GET)

  5. Ambilight config (POST)

  6. Ambilight cached (GET)

  7. Ambilight cached (POST)

  8. Ambilight mode (GET)

  9. Ambilight mode (POST)

  10. Ambilight lounge (GET)

  11. Ambilight lounge (POST)

  12. Ambilight proccesed (GET)

  13. Ambilight measured (GET)

  14. Ambilight topology (GET)

    Applications:

  15. Applications (GET)

  16. Activities current (GET)

  17. Activities launch (POST)

    Audio:

  18. Audio (GET)

  19. Audio (POST)

    (TO BE UPDATED) TV channels:

  20. Channel list (GET)

  21. EPG source (GET)

  22. Recordings (GET)

    TV settings:

  23. Settings menu (current) (POST)

  24. Settings menu structure (GET)

  25. Settings menu update (POST)

    TV remote control:

  26. Input key (POST)

  27. Power state (GET)

    Other:

  28. System (GET)

  29. Storage (GET)

  30. Timestamp (GET)