Rest API

curl -u "john@example.com:00001234cafecafe" "https://api.testfairy.com/api/1/projects/"

Returns a list of all projects (iOS and Android apps) in this account.
Responses
STATUS 200 OK

{
    "status": "ok",
    "projects": [
        {
            "id": "19-groupshot",
            "self": "/projects/19-groupshot",
            "name":"GroupShot",
            "packageName":"com.groupshot",
            "platform":"Android"
        }
    ]
}

Get all builds in a specific project. Each build is a distinct version that was either uploaded, or created by the TestFairy SDK.
Responses
STATUS 200 OK

{
    "status": "ok",
    "builds": [
        {
            "id": 2820564,
            "self": "/projects/2197059-mainactivity/builds/2820564",
            "appName": "My Mobile Application",
            "originalFilename": "my-mobile-application-release.apk",
            "fileSize": 129153,
            "uploadDate": "2017-12-20 22:03:00",
            "version": "1.0",
            "sessions": 14,
            "crashes": 3
        }
    ]
}

Get all crashes in a specific build. These crashes ungrouped, meaning, the same stack trace may appear multiple times (one for each session).
Responses
STATUS 200 OK

{
    "status": "ok",
    "crashes": [
        {
            "sessionId": 50571690,
            "testerEmail": "john@testfairy.com",
            "message": "android.content.ActivityNotFoundException: Unable to find explicit activity class {com.testfairy.apps.sample/com.testfairy.apps.sample.MemoryTest}; have you declared this activity in your AndroidManifest.xml?",
            "stackTrace": "android.content.ActivityNotFoundException: Unable to find explicit activity class {com.testfairy.apps.sample/com.testfairy.apps.sample.MemoryTest}; have you declared this activity in your AndroidManifest.xml? at android.app.Instrumentation.checkStartActivityResult(Instrumentation.java:1794) at android.app.Instrumentation.execStartActivity(Instrumentation.java:1512) at android.app.Activity.startActivityForResult(Activity.java:3917) at android.app.Activity.startActivityForResult(Activity.java:3877) at android.app.Activity.startActivity(Activity.java:4200) at android.app.Activity.startActivity(Activity.java:4168) at com.testfairy.apps.sample.MainActivity$14.onClick(MainActivity.java:187) at android.view.View.performClick(View.java:5198) at android.view.View$PerformClick.run(View.java:21147) at android.os.Handler.handleCallback(Handler.java:739) at android.os.Handler.dispatchMessage(Handler.java:95) at android.os.Looper.loop(Looper.java:148) at android.app.ActivityThread.main(ActivityThread.java:5417) at java.lang.reflect.Method.invoke(Native Method) at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:726) at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:616) "
        }
    ]
}

Get metadata for all sessions recorded for a specific build.
Responses
STATUS 200 OK

{
    "status": "ok",
    "sessions": [
        {
            "id": 1,
            "self": "/projects/2197059-demoapp/builds/4867553/sessions/1",
            "startTime": "2017-01-22 16:42:40",
            "duration": "15:01",
            "testerEmail": "john@testfairy.com",
            "device": "Samsung - Samsung Galaxy S8",
            "ipAddress": "23.100.122.175",
            "crashed": false,
            "countryName": "United States",
            "countryCode": "us"
        }
    ]
}

Get metadata (and optionally data) for a specific session.

parameter	type	description
fields	string	Possible values: "meta", "logs", "events" Default value: "meta" Use "events" to load all events, screenshots, touches and other metrices. Use "logs" to fetch only logs. When loading logs, response will be application/text.

Responses
STATUS 200 OK

{
    "status": "ok",
    "session": {
        "id": 1,
        "sessionStartTime": "2017-01-22 16:42:40",
        "duration": "15:01",
        "testerEmail": "john@testfairy.com",
        "device": "Samsung - Samsung Galaxy S8",
        "ipAddress": "23.100.122.175",
        "crashed": false
    }
}

List all testers in this account.
Responses
STATUS 200 OK

{
    "status": "ok",
    "testers": [
        {
            "email": "john@testfairy.com",
            "deviceCount": 3
        },
        {
            "email": "alice@testfairy.com",
            "deviceCount": 1
        }
    ]
}

Add a new tester to account. Optionally can add them to a group, and optionally send an invitation email.

parameter	type	description
email	string	One or more emails, separated by commas, to add to your account.
group	string	Assign tester or testers to this tester-group. Will create one if no such group exists. Default value: none
allow-all	string	Allow these testers to see all apps, including apps that will be uploaded in the future? Default value: false

Responses
STATUS 200 OK

{
    "status": "ok"
}