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",
            "icon":"[URL TO APP ICON]"
        }
    ]
}

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":8830728,
            "self":"/projects/6806100-myapplication/builds/8830728",
            "projectId":"6806100",
            "appName":"My Application",
            "appVersion":"DemoApp",
            "appVersionCode":"20",
            "appDisplayName":"My Application - DemoApp (20)",
            "iconUrl":"[APP ICON URL]",
            "appUrl":"[URL TO APK OR IPA FILE]",
            "sessions":6,
            "crashes":0,
            "testers":0,
            "feedbacks":0,
            "downloads":1,
            "uploadedAt":"2019-04-04 16:03:15",
            "uploadedVia":"[UPLOAD DETAILS]",
            "hasTestFairySdk":true,
            "insightsEnabled":true,
            "videoEnabled":true
        }
    ]
}

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":4426273741,
        "sessionStartTime":"2019-05-20 09:05:30",
        "duration":"00:27",
        "testerEmail":"blabla@ex.com",
        "device":"Xiaomi - Redmi S2",
        "ipAddress":"84.94.200.136",
        "crashed":false,
        "identity":{
            "correlationId":"blabla@ex.com",
            "attr3":"three",
            "attr4":"four",
            "attr1":"High",
            "attr2":"1.0",
            "attr5":"Version 1.0"
    }
}

List all testers in this account.
Responses
STATUS 200 OK

{
    "status": "ok",
    "testers": [
        {
            "email":"james@example.com",
            "groups":[{
                id: 100,
                name: "friends"
            }]
        },
        {
            "email":"alice@testfairy.com",
            "groups":[{
                id: 100,
                name: "friends"
            }, {
                id: 200,
                name: "family"
            }]
        }
    ]
}

Add a new tester to account. Optionally can add them to a group.

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
notify	string	Pass "notify=on" to send out a welcome email when inviting this tester. The email sent is the `Tester Welcome Email` template and can be configured. Default value: off

Responses
STATUS 200 OK

{
    "status": "ok"
}

Blocks a single tester. They cannot download the apps they were invited to. However, the data stays. You can later unblock this tester, or delete them completely. Responses
STATUS 200 OK

{
    "status": "ok"
}

Unblocks a single tester. Their invitations are restored. If the user is already unblocked, then nothing happens. Responses
STATUS 200 OK

{
    "status": "ok"
}

Delete a single tester, remove them from any tester-groups they might be in, and invalidate all invitations that were sent.
Responses
STATUS 200 OK

{
    "status": "ok"
}

Get metadata for 100 of the latest feedbacks recorded.
Responses
STATUS 200 OK

{
    "status": "ok",
    "feedbacks": [
        {
            "recorded_at": "2018-08-01 04:14:46",
            "text": "Feedback working",
            "feedbackId": "54321",
            "screenshotUrl": "https://s3.amazonaws.com/feedback.jpg",
            "buildId": "1234",
            "projectId": "23456",
            "recordedAt":"2018-08-01 14:14:46",
            "source": "shake",
            "reported_by": "john@testfairy.com",
            "session_id": "8765432"
        }
    ]
}
    

Get recent audit trail items
Responses
STATUS 200 OK

{
    "status": "ok",
    "audits": [
        {
            "id": 23534603,
            "timestamp": "2020-04-21 02:31:54",
            "ipAddress": "54.235.41.91",
            "eventType": "download_app",
            "eventData": {          
                "projectId": 6833287,
                "buildId": 9087976,
                "appName": "MyApp",
                "appVersion": "1.0 (10)",
                "testerEmail": "john@example.com",
                "filesize": 31348
            }
        }
    ]
}
    

Get the list of admins in the account and their permissions.
Responses
STATUS 200 OK

{
    "status": "ok",
    admins: 
    [
        {
            email: "joe@example.com",
            role: "account-owner",
            permissions: [
                "*:rw"
            ]
        },
        {
            email: "bob@example.com",
            role: "account-manager",
            permissions: [
                "*:rw"
            ]
        },
        {
            email: "alice@example.com",
            role: "admin",
            permissions: [
                "*:rw"
            ]
        },  
        {
            email: "michael@example.com",
            role: "admin",
            permissions: [
                "16527:rw",
                "16517:rw",
                "69237:r"
            ]
        },  
    ]
}
    

List all webhooks in this account.
Responses
STATUS 200 OK

{
    "status":"ok",
    "webhooks":[
        {
            "id":12,
            "status":"0",
            "name":"Slack Webhook @vijay",
            "url":"https://hooks.slack.com/services/",
            "actions":"crash,feedback,upload,new-udid",
            "projectIds":"12345,45643"
        }
    ]
}

Add a new webhook to account.

parameter	type	description
webhook-name	string	Required. The name of the webhook.
webhook-url	string	Required. The url for the webhook.
webhook-status	string	Enables or disables the webhook, true or false. Default value: false
actions	string	Comma separated list of actions. options include crash feedback upload new-udid
webhook-project-ids	string	Optional. Comma separated list of project IDs.

Responses
STATUS 200 OK

{
    "status": "ok"
}

Returns a single webhook. Responses
STATUS 200 OK

{
    "status": "ok",
    "webhook": {
        "id":12,
        "status":"0",
        "name":"Slack Webhook @vijay",
        "url":"https://hooks.slack.com/services/",
        "actions":"crash,feedback,upload,new-udid",
        "projectIds":"12345,45643"
    }
}

Modifies a single webhook.

parameter	type	description
webhook-name	string	Required. The name of the webhook.
webhook-url	string	Required. The url for the webhook.
webhook-status	string	Enables or disables the webhook, true or false. Default value: false
actions	string	Comma separated list of actions. options include crash feedback upload new-udid
webhook-project-ids	string	Optional. Comma separated list of project IDs.

Responses
STATUS 200 OK

{
    "status": "ok"
}

Delete a single webhook.
Responses
STATUS 200 OK

{
    "status": "ok"
}