# Genymotion HTTP API

Genymotion HTTP API allows you to remotely control all Genymotion widgets and edit the Genymotion device Configuration.

  1. Access the instance from a web browser.
  2. Click API reference:

API Reference

From there, choose the HTTP API request you are interested in for details. You can also test an API request by using the Try it out button.

Note

The API reference page can also be accessed from the URL https://{your_instance_IP}/documentation/api.

The HTTP API can be called using curl with the -u option for authentication.

For example:

curl -u {username}:{password} -X POST "https://{instance_IP}/api/v1/android/shell" -H  "accept: text/plain" -H  "Content-Type: application/json" -d "{\"commands\":[\"ls\"],\"timeout_in_seconds\":5}"

This will call the android/shell API and execute the command ls to the instance.

{username} and {password} are the instance credentials (see Change authentication for details). {instance_IP} is your instance IP.

Note

If you are not using a SSL/TLS certificate, you will need to add the -k switch to your curl command.

You can get the CURL command line (without authentication) when trying the API:

API example