Welcome to Rollee, the secure API for employment data.
Rollee makes it easy for your users to grant you access to their employment accounts.
Once one of your users grants access, your application can access his or her employment and income data.
Here is a quick overview of some concepts you will need in order to implement Rollee and get access to your user's data.
You will need a JWT token for each of the Sandbox and the Production environments and the URLs.
Once you have those you can Create a user via the API which will provide you with the Rollee Connect link where the user can connect their accounts via an interface. Once the user has connected their account you can start receiving data via the API. When creating a user you can add optional metadata such as your internal userID.
Get a list of connected accounts so you can start requesting data from these accounts.
Endpoints are sets of data that you can query through the API.
Once you query the API for data, some endpoints will require a date range such as Income. This can include the last X days, weeks or months. Queries with large date ranges will take longer to execute.
When querying the API you will need to specify which accounts you want the data for. Accounts represent the links between a
user and a
datasource. Users can have multiple
accounts if they connect to numerous
datasources through Connect.
You will need to integrate Rollee Connect into your application or product flow in order for the users to share their data. You should ensure that the users have context before asking them to complete the Rollee flow for better conversion.
You can integrate via SDK or webview on mobile or desktop. For customizations, you will need to use the SDK.
We standardize all information retrieved from platforms and serve it via endpoints to make it easier to consume the relevant data. The examples provided below show all of the data points we are able to retrieve, provided they are available on the platform. The following is a list of endpoints that are supported:
Full name - Thibaud Duprat
Profile includes all data points relating to the identity of a user.
Document Type - Paystub
The documents endpoints provide access to all downloadable documents available on a platform. From paystubs to identity related documents.
Company - Uber
Income is where you can see the users earnings over a period of time. For this endpoint Gross and earnings maybe be determined by trips or paystubs.
Selected Period - 11 June - 28 June
Activity is based on a set period determined within the API call. We calculated the follow data points based on the trips available in that time period.
Payment - Cash
The Trips endpoint will provide you with a list of all trips and details in the period of time requested.
Make - Jeep
Vehicles endpoint provides information of the vehicles a driver has registered with the platform.
Title - Driver
The Employment endpoint provide additional information on the employment of the user in relation to the account queried.
Rollee provides your company with user-permissioned data. We provide various endpoints with relevant information such as Income, Identity, Activity, and Employment. With Rollee you can empower your users to use your service in just a few clicks.
Rollee enables you to start making more informed decisions based on standardized and reliable data.
The Rollee Connect allows users to easily 'connect' their accounts in order to provide you with the necessary data. A demo can be seen on our website.
It is important for you to know where Connect fits into your workflow and how best to integrate it in order to have the best user experience. We are happy to work closely with you to ensure the best conversion and ease of use for your users.
We understand how important it is to have a cohesive user experience, so we’ve made Connect customizable according to your needs. The following are currently available customizations:
- Your company Logo (required)
- Skipping the Connect intro screen
- Changing CTA colours to match your brand
- Changing the words on the intro page to match your app's user flow
- Removing the Add more accounts flow on the last screen for a one and done workflow
Updated about 1 month ago