NOTE: Be aware, if you use this with the other IFTTT integration, you could get yourself into an infinite loop of funness.

QUOTA: There is a quota allowed per ID or Access Token. The current quota is 50 requests in a 5 minute time period. If you exceed that quota your account will be banned from the public API automatically. If you need additional quota, please reach out to us at support@babystats.org.

We have opened up a public API that can be used by your own home automation projects, or can be used by IFTTT web hooks. In order to use this API, click the button below to generate an "accessToken". This token needs to be supplied with every request or we will reject your request. Ensure you save this token for use later.

If you are not technical, don't worry below that will show you how to get the data into IFTTT. Just fill in the "YOUR ACCESSS TOKEN GOES HERE" (if you don't have an access token click Generate Access Token) and enter your ID in the "YOUR ID GOES HERE".

• URL: https://www.babystats.org/api/public
• Method: POST
• ContentType: application/json

Fields that are shared across all event Types

A request that adds a wet diaper, then tells the API to return SSML.

A request that adds a wet diaper, then tells the API to return BabyData, but limits it to 5 days and only returns the BabyCount data (not BabyTransaction).

Integrating with IFTTT Web Hooks

In order to use our public API with IFTTT follow these steps. If you are not planning on using IFTTT you can skip lower.

1. Create a new Applet, and select the "this" portion of the applet. It could be any event you want to trigger counting a stats on baby stats.
2. Chose "Webhooks" for the action service, then select "Make a web request".
3. 
4. 

Baby Data:

The GetData request will return a "BabyData" object. The documentation below will explain what that object is, along with all of the fields/properties of it.

{
        "status": true,                               
        "statusMessage": "",
        "ssml": "",
        "data": {
            "ifttt": null,
            "lastStats": { },                    
            "lastNStats": { },
            "countsInTheLast": {
            "hours24": { },
            "hours12": { },
            "hours6": { },
            "hours1": { }
            },
            "dueDate": "2018-07-02",
            "deletedBabies": [],
            "babies": [],
            "seenThings": [ ],
            "previous": [ ],
            "guid": "string",
            "id": "string",
            "timezone": "unknown",
            "babystats": [ ],
            "transactions": [ ],
            "weights": [ ],
            "notes": [ ],
            "sleep": [ ],
            "pumping": [ ],
            "kick": [ ],
            "startSleep": {},
            "startFeeding": {},
            "uom": "ml",
            "uomType": "us"
        }
        }
                                

Explanation of BabyData parameters

babyTransaction:

The babyTransaction is the object used to store all counts. There is only 1 object for a count, and different types will use different fields depending on the requestType.

                    
{
    "uom": "oz",
    "breastSide": 0,
    "uid": "0a0661d1-c747-4817-a380-bf274fb8f69f",
    "requestType": 2,
    "note": null,
    "weight": 0,
    "wet": 0,
    "stool": 0,
    "feeding": 1,
    "bOz": 0,
    "sleep": 0,
    "feedingMinutes": 0,
    "transactionDateTime": "2018-06-19T23:22Z"
}
                              
                            

Explanation of babyTransaction parameters

baby:

The baby object is used when a user uses multiple babies. It's important to note. If a user has multiple babies you will need to do 2 GetData requests for displaying counts. 1 to get the header information, then a second against the baby of the information you want to display.

                    
{
"spokenName": "coleman",
"displayName": "Coleman",
"id": "731954344",
"isDefault": false
}
                              
                            

Explanation of baby parameters

babyCount:

The babyCount is a calculated field. It contains the rollup of all stats by day. You can use noCountsByDay to control if this is sent in the response. noCountsByDay = true means this array will be empty. You can also use numberOfDays to control the number of days returned. These 2 fields are to help your app be more responsive. Instead of sending all data in the request you can just have it send a little bit.

                    
{
    "uom": "oz",
    "bOz": 0,
    "wet": 1,
    "stool": 1,
    "feeding": 4,
    "feedingMinutes": 0,
    "date": "2018-01-12",
    "sleepCount": 0,
    "sleep": 0,
    "pumping": 0,
    "pOz": 0,
    "kicks": 0
}
                                  
                                

Explanation of baby parameters