Getting started with Self Developer

Getting Started

Here's how to get set up on our Developer Hub.

Follow the instructions below, download our Android app from the Play Store (iOS will be released shortly) and work through the quick start guide to familiarise yourself with Self and the Self Network.


Everything starts with the Self app. Download it to your Android phone and join the Self Network to set up your personal account.

Get it on Google Play
Self screenshot: Add facts to your Self from one of these sources


You'll need to verify at least your email address to register a developer account on the Self Network.

3. Go to our Developer Portal

Now you can use Self to access our developer portal immediately.

Developer portal
Self scanning a QR code to create a connection
Self Authorise fact sharing screenshot

4. Complete your self developer regIstration

We ask you to share your name and email with us from Self (we don't have it already – it's safely stored in your Self app)


We've put together a comprehensive guide to get you up to speed in under half an hour, with sample code in Ruby, Go and shortly Typescript.

Self code samples in Ruby, Go and Typescript

Frequently Asked Questions

Answers to commonly asked questions
What do you mean 'facts' can be stored in Self?

A fact is just a piece of information about you. The most basic facts stored in the Self data store in your phone are the ones you use to sign up: your email address, street address, your phone number, date of birth the personal details on your passport or driving license.

If a fact has been verified as being true by an authoritative third party it will be marked with a tick.

You can only share facts over the Self Network which have been verified, so you should try to get as many facts verified as possible.

How is this useful?

Imagine if you've just finished a foreign language course – the course providers could attest to the fact that you've achieved a level of competence in French, and you could store this as a verified fact in Self. That would mean you could use that fact in the future, for example when registering on a job platform, so potential employers know that someone they can trust says that "Oui, ils peuvent parler français!".

One important thing is that someone doesn't need to know the details to know that a fact is true. If you're buying age restricted goods online, the retailer doesn't need to know your date of birth, they just need to know that you're over a certain age. This is a powerful way of protecting your data, while being able to prove useful things about yourself.

And all of this information is just on your phone, always under your control.

How does Self compare to Two Factor Authentication apps?

Self can be used as a factor in multi-factor authentication, but because Self is proving more than that you have access to some keys it delivers more value to the organisation requesting authentication than just an app. Self can tell them that it's the specific person who should be being given access in real time. It can also add to that payload things like whether the person being authenticated has passed a KYC check and if they are the same person as the one who did the previous KYC check. Giving the organisation authentication with real value in real time.

How do I back up the data I have in Self?

All data stored in Self is encrypted on your mobile device. Any data you share is backed-up to your phone's cloud backup (e.g. iCloud or Google Drive) in a location nominated by you during the signup process. The backups of your data and account details will be encrypted end-to-end and then stored encrypted in your device's backups. 

We don’t have any access to your backups.

It is your responsibility to keep your phone, login details and recovery details safe, and to prevent others from having unauthorised access to your data.

Which facts can I verify with Self?

The Self app is a tool which lets you verify facts about yourself, so that you can use and share them safely when you need to over the Self Network. At beta launch the number of Facts that Self will support is limited (things like identity and contact information), but eventually we will support almost any piece of information which can be verified by someone else. 

All of this information stays on your device, under your control. It is never stored in the Cloud or in a big database with other peoples Facts. It’s just on your phone. 

You can only share facts over the Self Network which have been verified, so you should try to get as many facts verified as possible.

How much does Self cost?

Self is free to join as an individual user for personal use and the core features will always be free to you in the future.

Our business model is to charge the businesses using Self a small amount of money every time they ask to check a fact about you – such as your phone number, address, qualifications, passport number etc. – when you choose to connect with them using Self. They get certainty that the information you've shared is true, and you can be sure that your data isn't being used in ways you haven't explicitly agreed to.

In the future we may release new features, which may carry a charge, but these will always be optional.

For full details of our pricing and packages for businesses, see our Pricing page.

How does Self compare to password storage apps like 1Password and LastPass?

Self supports allows authentication without the need for usernames, passwords or anything you need to remember – just being you is enough. Lots of sites will still use passwords and usernames for a long time to come, so for those, password apps are great, but where you can login with Self it’s easier and safer than usernames, passwords or 2FA.

Why is it better to store my data on my phone than in the cloud?

Security, security, security.

Data stored in ‘the cloud’ is actually stored on servers located all over the world. These servers can be accessed from absolutely anywhere and the data on them is only as safe as the humans that set up the protection around them. As many high profile data breaches have shown (Twitter, British Airways, Zoom, the list goes on), these security measures are not up to the task of keeping out ever more skilled and ambitious hackers.

If your data is stored on your phone, it can’t be hacked like this. The fingerprint or face scan you use to unlock your phone is almost impossible to hack and, so is the data itself. 

The other issue with allowing companies to store your personal data is that once you’ve given a company some of your personal information, it’s easy to forget what you’ve shared with them and impossible to control how they use it. This misuse of data is becoming more widespread as businesses try to squeeze more and more value out of the information that they hold about their customers.

When you store your data on your device you remain in complete control of that information. You decide exactly which pieces of data to share with a company and you will be able to decide precisely what they can use it for and how long they can keep it.

Any more questions?

We know  that Self is a new way of doing things, so we'd love to hear what you think, and what you'd like to use it for.

Contact us