Actofit SmartScale APP API

Actofit Smartscale  app is best suited for dietitians, nutritionist, health clinics, gyms and fitness clubs, wherein database management becomes an uphill task due to more and more people turning up every day. Now, create, store and manage data points on your device for endless users, all within our app. All the data collected in this app is also available over the API 

How Actofit Smart Scale Measures body Composition

Actofit smart scale uses advanced Bioelectric Impedance Analysis (BIA) technology. When you stand on a smart scale a very low, safe electrical signals of high and low frequencies are sent from four transparent glass electrodes through your feet to your legs and abdomen. 

Based on the different impedance values the human body is segmented in the different virtual compartment mainly Body Water, Body Fat, Fat Free Mass, Bone etc. On the cellular body-composition level, FFM can be further divided into 3 components: body cell mass (BCM), extracellular fluid (ECF), and extracellular solids (ECS). So the total Fat free mass  is (FFM=BCM+ECF+ECS)

How to use Actofit Smartscale API

  1. Install and Login into the Actofit Smartscale app from here
  2. Create the members profile into the app from “Add user page” in the app
  3. While adding the user you must enter member’s email address or mobile number as it is needed for user identification over the API
  4. Ask the member to stand on the scale bare foot and select that members profile from the user page, Member should stand on the scale till the complete analysis gets over and all 15 body composition parameters get displayed on the app
  5. Now these 15 body composition parameters data can be fetched through the REST API
  6. To access this API you will need a access token, Please email us at or submit the API registration form
    Register here for Access token
  7. To fetch any members data you must pass the member’s email address or mobile number to the API
  8. Based on the email address or mobile number the member’s unique user id will be provided (Get user id API)
  9. By using member’s unique id you can fetch member’s entire body composition data in json format (Get user data API)

Actofit Smart Scale API Documentation:


The following APIs will use bearer token based authentication method. The token can be received by contacting actofit at “”

Get user id (_id):

You can find any registered user’s user id (_id) by sending his email or mobile number to this API. In response the API will provide the user id (_id)  of the registered user

Make a GET request to

Here in the parameter email you can send user’s email or mobile as a value

Get user data:

The user’s body paraments data can be fetched through following API. Make a GET request to

The user_id (example: 5af9cdd21e6e5a43647bc34c)  can be retrieved from previous API as (_id)

User data fetching:

On the successful request to “get user data” API the following JSON response will be received, here every json object represents one measurement event

“code”: 1,
“message”: “user data”,
“data”: [
“_id”: “5df9ce2f979a2df690ecc801”,
“user_id”: “5df9cdd21e6e5a43657bc34c”,
“timestamp”: 1569232470000,
“device_id”: “undefined”,
“weight”: 56.6,
“bmi”: 19.6,
“body_fat”: 18.5,
“physique”: 4,
“fat_free_weight”: 46.1,
“subcutaneous_fat”: 17.2,
“visceral_fat”: 3,
“body_water”: 58.9,
“skeletal_muscle”: 46.5,
“muscle_mass”: 43.8,
“bone_mass”: 2.3,
“protein”: 18.6,
“bmr”: 1366,
“metabolic_age”: 23,
“health_score”: 89.8,
“createdAt”: “2019-09-23T09:54:31.000Z”,
“updatedAt”: “2019-12-19T08:06:49.162Z”
“_id”: “5df9ce2b979a2df690ea8d5f”,
“user_id”: “5df9cdd21e6e5a43657bc34c”,
“timestamp”: 1530520786000,
“device_id”: “undefined”,
“weight”: 71.8,
“bmi”: 24.3,
“body_fat”: 22.9,
“physique”: 1,
“fat_free_weight”: 55.3,
“subcutaneous_fat”: 20.6,
“visceral_fat”: 7,
“body_water”: 55.6,
“skeletal_muscle”: 43.9,
“muscle_mass”: 52.6,
“bone_mass”: 2.8,
“protein”: 17.6,
“bmr”: 1565.1,
“metabolic_age”: 23,
“health_score”: 89,
“createdAt”: “2018-07-02T08:39:46.000Z”,
“updatedAt”: “2019-12-19T08:00:25.234Z”

Parameters Measured by Actofit SmartScale APP

1) Body Weight:

Users body weight is measured with higher accuracy. The maximum weight that the smart scale can measure is 210Kg.

2) Body Fat Percentage:

The body fat percentage (BFP) of a human or other living being is the total mass of fat divided by total body mass, multiplied by 100; body fat includes essential body fat and storage body fat. The body fat percentage is a measure of fitness level.  

3) Visceral Fat:

Visceral fat is located deep in the core abdominal area, surrounding and protecting the vital organs. Even if your weight and body fat remains constant, as you get older the distribution of fat changes and is more likely to shift to the abdominal area. Ensuring you have a healthy level of visceral fat directly reduces the risk of certain diseases such as heart disease, high blood pressure and may delay the onset of type 2 diabetes.

4) Muscle Mass:

The predicted weight of muscle in your body. Muscle mass includes the skeletal muscles, smooth muscles such as cardiac and digestive muscles and the water contained in these muscles. Muscles act as an engine in consuming energy. As your muscle mass increases, the rate at which you burn energy (calories) increases which accelerates your basal metabolic rate (BMR) and helps you reduce excess body fat levels and lose weight in a healthy way.

5) Total Body Water:  

Total Body Water is the total amount of fluid in the body expressed as a percentage of total weight. Body water is an essential part of staying healthy. Over half the body consists of water. It regulates body temperature and helps eliminate waste.

6) Bone Mass:

The predicted weight of bone mineral in your body. While your bone mass is unlikely to undergo noticeable changes in the short term, it’s important to maintain healthy bones by having a balanced diet rich in calcium and by doing plenty of weight-bearing exercises.

7) Physique Rating:

The amount of muscle and body fat levels decides your physique rating. Depending on physique rating human body type can be differentiated in nine body types. As your activity level changes, the balance of body fat and muscle mass will gradually change, which in affects your overall physique.

8) Basal Metabolic Rate (BMR):

The daily minimum level of energy or calories your body requires when at rest (including sleeping) in order to function effectively. Increasing muscle mass will speed up your basal metabolic rate (BMR). A person with a high BMR burns more calories at rest than a person with a low BMR.

9) Metabolic Age:

Metabolic age is calculated by comparing your basal metabolic rate (BMR) to the BMR average of your chronological age group. If your metabolic age is higher than your actual age, it’s an indication that you need to improve your metabolic rate.

10) Body Mass Index (BMI):

A standardised ratio of weight to height used as a general indicator of health. Your BMI can be calculated by dividing your weight (in kilograms) by the square of your height (in meters).

11) Fat Free Weight:

Fat-free mass, also known as lean body mass, refers to all of your body components except fat. It includes your body’s water, bone, organs, and muscle content.

12) Subcutaneous Fat:

As the name suggests subcutaneous fat is a fat located under the skin. The amount of subcutaneous fat you develop depends on genetics as well as lifestyle factors such as physical activity and diet. Subcutaneous fat is an important part of your body, but if your body is storing too much of it, you may be at a higher risk for health problems

13) Skeletal Muscle %:

A muscle which is connected to the skeleton to form part of the mechanical system which moves the limbs and other parts of the body. Skeletal muscle % is the ratio of your skeletal muscle mass to the total muscle mass multiplied by 100

14) Body Protein %:

Protein is an important component of every cell in the body. Hair and nails are mostly made of protein. Your body uses protein to build and repair tissues. You also use protein to make enzymes, hormones, and other body chemicals. Protein is an important building block of bones, muscles, cartilage, skin, and blood.

15) Health Score:

Your health score is calculated by assessment of all body parameters. The higher health score is an indication of good physical health.