curl --request GET \
--url https://b2b-api.dev-riseworks.io/v2/mapping \
--header 'Authorization: Bearer <token>'import requests
url = "https://b2b-api.dev-riseworks.io/v2/mapping"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://b2b-api.dev-riseworks.io/v2/mapping', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://b2b-api.dev-riseworks.io/v2/mapping",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://b2b-api.dev-riseworks.io/v2/mapping"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://b2b-api.dev-riseworks.io/v2/mapping")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://b2b-api.dev-riseworks.io/v2/mapping")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"scope": "company",
"company": {
"nanoid": "<string>",
"riseid": "<string>",
"rise_account": "<string>",
"v1_id": 0,
"v1_riseid": "<string>",
"name": "<string>"
},
"teams": [
{
"nanoid": "<string>",
"riseid": "<string>",
"rise_account": "<string>",
"v1_id": 0,
"v1_riseid": "<string>",
"name": "<string>"
}
],
"users": [
{
"nanoid": "<string>",
"riseid": "<string>",
"rise_account": "<string>",
"v1_id": 0,
"v1_riseid": "<string>",
"email": "<string>",
"company_roles": [
"<string>"
],
"teams": [
{
"team_nanoid": "<string>",
"role": "<string>",
"type": "manager",
"pay_handler": "<string>"
}
]
}
],
"pagination": {
"page": 123,
"count": 123,
"offset": 123,
"has_more": true,
"next_page": 123,
"next_offset": 123
}
}
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}Map V1 ids to V2 ids
Returns a company’s teams and users (managers and payees) with their V1 ids and V1 RiseIDs alongside the V2 nanoids, RiseIDs and RiseAccounts, plus each payee’s pay handler per team. Use it to translate the identifiers stored by a V1 integration before switching to the V2 API. Entities created in V2 are included with null V1 fields. The company owner and org roles get the whole company (scope: company); a team manager without an org role gets only the teams they can read (scope: teams). An unknown company and one you have no access to both return 404 Company not found, so the endpoint never reveals other companies. Supports optional offset pagination over users via page/offset/count; without them the full list is returned.
curl --request GET \
--url https://b2b-api.dev-riseworks.io/v2/mapping \
--header 'Authorization: Bearer <token>'import requests
url = "https://b2b-api.dev-riseworks.io/v2/mapping"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://b2b-api.dev-riseworks.io/v2/mapping', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://b2b-api.dev-riseworks.io/v2/mapping",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://b2b-api.dev-riseworks.io/v2/mapping"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://b2b-api.dev-riseworks.io/v2/mapping")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://b2b-api.dev-riseworks.io/v2/mapping")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"scope": "company",
"company": {
"nanoid": "<string>",
"riseid": "<string>",
"rise_account": "<string>",
"v1_id": 0,
"v1_riseid": "<string>",
"name": "<string>"
},
"teams": [
{
"nanoid": "<string>",
"riseid": "<string>",
"rise_account": "<string>",
"v1_id": 0,
"v1_riseid": "<string>",
"name": "<string>"
}
],
"users": [
{
"nanoid": "<string>",
"riseid": "<string>",
"rise_account": "<string>",
"v1_id": 0,
"v1_riseid": "<string>",
"email": "<string>",
"company_roles": [
"<string>"
],
"teams": [
{
"team_nanoid": "<string>",
"role": "<string>",
"type": "manager",
"pay_handler": "<string>"
}
]
}
],
"pagination": {
"page": 123,
"count": 123,
"offset": 123,
"has_more": true,
"next_page": 123,
"next_offset": 123
}
}
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}{
"success": false,
"data": "<string>",
"error_code": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Company to map, in any form you hold: a V1 company or team id, a company (co-) or team (te-) nanoid, a V1 or V2 RiseID, or a RiseAccount. A team resolves to its company. Defaults to the company you own; required if you own more than one.
Same as company_id with a co- nanoid; kept for compatibility. Send one or the other: both together returns 400.
15^co-.*1-indexed page number.
Row offset (alternative to page).
Page size, 1-500 (default 100). Pagination only activates when page or offset is set.
