Precedent logo

api

Quickstart

This guide will get you all set up and ready to use the OneTwentyone API. We’ll cover how to get started with your personal access token and make your first API request.

Before you can make requests to the OneTwentyOne API, you will need to create a OneTwentyOne account by downloading the 121 Health App. You must complete the sign on process in the app before creating your API client, so do this now.

How it works

The 121 Health app provides a longevity-focused health analysis to iOS users. It personalizes insights by using all possible health data, from Apple Watch data to blood tests to supplements.

The OneTwentyOne API allows you to programatically access our unified API for users of your application (or just yourself). We are going to cover how to set up your personal access token and get you on your way to accessing your personal health data. If you are interested in developing a client to access your users health data, and want to skip this step, check out our Client OAuth page.

Create a PAT

After creating your account in the 121 Health app, sign in and create a personal access token. Enter a note to customize your token, and click create your personal access token.

Personal Access Tokens give you access to all our scopes, which include sleep, workout, quantity, profile, and all future scopes.

After you create a PAT, make sure you save your token because you can only see your client secret once. Don't lose it, or else all you will have to delete the token and create a new one. You are free to create as many personal access tokens as you like!

Making your first API request

After you've followed the steps above with your own account, you're ready to make your first API request. Try a simple request to the GET request /api/v1/quantity/user_id/stepCount (replacing user_id with your user_id found on the PAT page) endpoint to get your step count. Make sure you include a Bearer {PAT} header in your request.

What's next?

Great, you're now set up with an API client and have made your first request to the API. Here are a few links that might be handy as you venture further into the OneTwentyOne API:

Was this page helpful?