addCompanyLocation
curl --request POST \
--url https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"method": "addCompanyLocation",
"companyLocation": {
"companyId": "33A04AFB-4317-464A-B1E0-BAB610086174",
"companyLocation": "Main",
"address1": "8745 Colard Ln",
"address2": "",
"city": "Lyons",
"state": "CO",
"zipcode": "80540",
"phoneNumber": "9889890989",
"isWorkLocation": true,
"isMailingAddress": true,
"isFilingAddress": true
}
}
'import requests
url = "https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation"
payload = {
"method": "addCompanyLocation",
"companyLocation": {
"companyId": "33A04AFB-4317-464A-B1E0-BAB610086174",
"companyLocation": "Main",
"address1": "8745 Colard Ln",
"address2": "",
"city": "Lyons",
"state": "CO",
"zipcode": "80540",
"phoneNumber": "9889890989",
"isWorkLocation": True,
"isMailingAddress": True,
"isFilingAddress": True
}
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
method: 'addCompanyLocation',
companyLocation: {
companyId: '33A04AFB-4317-464A-B1E0-BAB610086174',
companyLocation: 'Main',
address1: '8745 Colard Ln',
address2: '',
city: 'Lyons',
state: 'CO',
zipcode: '80540',
phoneNumber: '9889890989',
isWorkLocation: true,
isMailingAddress: true,
isFilingAddress: true
}
})
};
fetch('https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation', 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://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'method' => 'addCompanyLocation',
'companyLocation' => [
'companyId' => '33A04AFB-4317-464A-B1E0-BAB610086174',
'companyLocation' => 'Main',
'address1' => '8745 Colard Ln',
'address2' => '',
'city' => 'Lyons',
'state' => 'CO',
'zipcode' => '80540',
'phoneNumber' => '9889890989',
'isWorkLocation' => true,
'isMailingAddress' => true,
'isFilingAddress' => true
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation"
payload := strings.NewReader("{\n \"method\": \"addCompanyLocation\",\n \"companyLocation\": {\n \"companyId\": \"33A04AFB-4317-464A-B1E0-BAB610086174\",\n \"companyLocation\": \"Main\",\n \"address1\": \"8745 Colard Ln\",\n \"address2\": \"\",\n \"city\": \"Lyons\",\n \"state\": \"CO\",\n \"zipcode\": \"80540\",\n \"phoneNumber\": \"9889890989\",\n \"isWorkLocation\": true,\n \"isMailingAddress\": true,\n \"isFilingAddress\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"method\": \"addCompanyLocation\",\n \"companyLocation\": {\n \"companyId\": \"33A04AFB-4317-464A-B1E0-BAB610086174\",\n \"companyLocation\": \"Main\",\n \"address1\": \"8745 Colard Ln\",\n \"address2\": \"\",\n \"city\": \"Lyons\",\n \"state\": \"CO\",\n \"zipcode\": \"80540\",\n \"phoneNumber\": \"9889890989\",\n \"isWorkLocation\": true,\n \"isMailingAddress\": true,\n \"isFilingAddress\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"method\": \"addCompanyLocation\",\n \"companyLocation\": {\n \"companyId\": \"33A04AFB-4317-464A-B1E0-BAB610086174\",\n \"companyLocation\": \"Main\",\n \"address1\": \"8745 Colard Ln\",\n \"address2\": \"\",\n \"city\": \"Lyons\",\n \"state\": \"CO\",\n \"zipcode\": \"80540\",\n \"phoneNumber\": \"9889890989\",\n \"isWorkLocation\": true,\n \"isMailingAddress\": true,\n \"isFilingAddress\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"companyLocation": {
"companyLocationId": "EAE2367A-F86E-4495-B403-627FCCFD8184",
"status": "Verification pending",
"message": "Company Location has been saved successfully."
}
}Company Onboarding
addCompanyLocation
The addCompanyLocation API is used to add a company location. This step sets up the company’s primary physical location and is essential for regional compliance, tax jurisdiction, and audit readiness.
What it does:
- Establishes the company’s physical presence and operational address
- Enables proper tax jurisdiction for payroll processing and ensures regional compliance
Location Options:
| Location | Description |
|---|---|
| WorkLocation | Physical addresses where the company has employees working in the United States |
| MailingAddress | Address where company correspondence and official mail is sent |
| FilingAddress | Address used for tax filings and regulatory submissions with government agencies |
Notes:
- This step must be completed before beginning the KYB verification process and is required for accurate payroll processing across different jurisdictions.
- Companies must maintain at least one filing address at all times
POST
/
companyOnboarding
/
addCompanyLocation
addCompanyLocation
curl --request POST \
--url https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"method": "addCompanyLocation",
"companyLocation": {
"companyId": "33A04AFB-4317-464A-B1E0-BAB610086174",
"companyLocation": "Main",
"address1": "8745 Colard Ln",
"address2": "",
"city": "Lyons",
"state": "CO",
"zipcode": "80540",
"phoneNumber": "9889890989",
"isWorkLocation": true,
"isMailingAddress": true,
"isFilingAddress": true
}
}
'import requests
url = "https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation"
payload = {
"method": "addCompanyLocation",
"companyLocation": {
"companyId": "33A04AFB-4317-464A-B1E0-BAB610086174",
"companyLocation": "Main",
"address1": "8745 Colard Ln",
"address2": "",
"city": "Lyons",
"state": "CO",
"zipcode": "80540",
"phoneNumber": "9889890989",
"isWorkLocation": True,
"isMailingAddress": True,
"isFilingAddress": True
}
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
method: 'addCompanyLocation',
companyLocation: {
companyId: '33A04AFB-4317-464A-B1E0-BAB610086174',
companyLocation: 'Main',
address1: '8745 Colard Ln',
address2: '',
city: 'Lyons',
state: 'CO',
zipcode: '80540',
phoneNumber: '9889890989',
isWorkLocation: true,
isMailingAddress: true,
isFilingAddress: true
}
})
};
fetch('https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation', 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://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'method' => 'addCompanyLocation',
'companyLocation' => [
'companyId' => '33A04AFB-4317-464A-B1E0-BAB610086174',
'companyLocation' => 'Main',
'address1' => '8745 Colard Ln',
'address2' => '',
'city' => 'Lyons',
'state' => 'CO',
'zipcode' => '80540',
'phoneNumber' => '9889890989',
'isWorkLocation' => true,
'isMailingAddress' => true,
'isFilingAddress' => true
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation"
payload := strings.NewReader("{\n \"method\": \"addCompanyLocation\",\n \"companyLocation\": {\n \"companyId\": \"33A04AFB-4317-464A-B1E0-BAB610086174\",\n \"companyLocation\": \"Main\",\n \"address1\": \"8745 Colard Ln\",\n \"address2\": \"\",\n \"city\": \"Lyons\",\n \"state\": \"CO\",\n \"zipcode\": \"80540\",\n \"phoneNumber\": \"9889890989\",\n \"isWorkLocation\": true,\n \"isMailingAddress\": true,\n \"isFilingAddress\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"method\": \"addCompanyLocation\",\n \"companyLocation\": {\n \"companyId\": \"33A04AFB-4317-464A-B1E0-BAB610086174\",\n \"companyLocation\": \"Main\",\n \"address1\": \"8745 Colard Ln\",\n \"address2\": \"\",\n \"city\": \"Lyons\",\n \"state\": \"CO\",\n \"zipcode\": \"80540\",\n \"phoneNumber\": \"9889890989\",\n \"isWorkLocation\": true,\n \"isMailingAddress\": true,\n \"isFilingAddress\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.rollfi.xyz/companyOnboarding/addCompanyLocation")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"method\": \"addCompanyLocation\",\n \"companyLocation\": {\n \"companyId\": \"33A04AFB-4317-464A-B1E0-BAB610086174\",\n \"companyLocation\": \"Main\",\n \"address1\": \"8745 Colard Ln\",\n \"address2\": \"\",\n \"city\": \"Lyons\",\n \"state\": \"CO\",\n \"zipcode\": \"80540\",\n \"phoneNumber\": \"9889890989\",\n \"isWorkLocation\": true,\n \"isMailingAddress\": true,\n \"isFilingAddress\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"companyLocation": {
"companyLocationId": "EAE2367A-F86E-4495-B403-627FCCFD8184",
"status": "Verification pending",
"message": "Company Location has been saved successfully."
}
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
Response
Show child attributes
Show child attributes