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

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.

parameter	type	description
email	string	An email address of a tester to be removed.

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 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"
            ]
        },  
    ]
}