📘

Contact us for a token

The sandbox is a development environment filled with sample data to help simulate a Relativity6 production environment. If you don't have a token to the sandbox environment, please contact us at [email protected]

REST API Set-Up

Introduction: An Enabled Version for Testing Environments

To use this API, a registered token and URL is required to make requests to the Relativity6
Platform. For testing purposes we will provide a fixed token that you can use as many times as you need.
When you’re ready to use the system in production, we will send the credentials to the
production environment platform.

Calling the API

In this step, you will need to make a HTTP Post call to the following endpoint:

https://api.relativity6.guru/naics/naics/search

Introduce the next parameters, using a JSON object:

● Token: The token provided by the platform.
● Name: Name of the business entity.
● Address: The address of the business entity (Optional).
● State: Two letters state code (Optional, *if left blank will return an error message in the existence check field)

API Response

The API will return a JSON object response that contains two possible NAICS predictions for the
business entity provided, and a message confirming that the request was successfully fetched.

Example:

We are going to make an API request, using a user credential test. In this example, we are
looking for the NAICS classification of "John's Flower Shop", within the State of California.

{
"token": "*********************b5c2",
"name": "John's Flower Shop",
"address": "2 Orchid St. Daisy, 90077",
"state": "CA"
}

Taking 600 milliseconds on average, the response looks as follows, with three probabilistically
inferred NAICS titles and codes for the business entity inquired:

{
  "usa_naics_2017_prediction": {
    "prediction_a": {
      "title": "Florists",
      "code": 453110,
      "accuracy": 0.75
    },
    "prediction_b": {
      "title": "Confectionery and Nut Stores",
      "code": 445292,
      "accuracy": 0.74
    }
  },
  "existence_check": {
    "exists": true,
    "evidence_exist": [
      "https://johnsflowers.com",
      "https://www.flowersdirectory.com/johns-flowers/daisy-ca",
    ]
  },
  "response_id": "613983817b834e2bcbe04adn5a1ei68af8196f15d8pe2",
  "response_timestamp": "2022-01-13 10:19:12 CST",
  "response_execution_time": "355 ms",
  "response_notification": "Relativity6 calculated the prediction output successfully",
  "request": {
    "token": "****************************1c7c",
    "name": "John's Flowers",
    "intelligentName": "johns flowers",
    "address": "2 Orchid St. Daisy, 90077",
    "state": "CA",
    "predictionType": "USA_NAICS_2017",
    "advancedSearch": true,
    "prediction": true,
    "existenceCheck": true
  }
}

The last line displayed illustrates a sample proxy for confirming a successful data transmission
through the API.

Credentials for your Sandbox Environment

For this Sandbox Environment, there is no cap on the “One-at-a-time” calls you can make per
day.

TOKEN: {ask for a token at [email protected]}
API NAICS URL: https://api.relativity6.guru/naics/naics/search

Sample Dataset

The value in the "name" parameter for the sandbox REST API call should be one of the
companies shown in the table below. Otherwise, the response will display the following default
message:

{
   "usa_naics_2017_prediction":{
      "prediction_a":{
         "title":"All Other Business out of the sample",
         "code":999999,
         "accuracy":0
      },
      "prediction_b":{
         "title":"All Other Business out of the sample",
         "code":999999,
         "accuracy":0
      }
   },
   "existence_check":{
      "exists":true,
      "evidence_exist":[
         "www.bing.com",
         "www.google.com"
      ]
   },
   "response_id":"re0lat382iv938ya6d86d9ro48il21x4c28a752747b6m",
   "response_timestamp":"2022-01-13 10:56:22 CST",
   "response_execution_time":"1500 ms",
   "response_notification":"Relativity6 calculated the prediction output successfully",
   "request":{
      "token":"**********1b24",
      "name":"amazon",
      "intelligentName":"amazon",
      "address":"",
      "state":"MS",
      "predictionType":"USA_NAICS_2017",
      "advancedSearch":true,
      "prediction":true,
      "existenceCheck":true
   }
}

Samples

Company name

State

Happie Hippie Plant Shop

TN

M&L HVAC LLC

OH

Kardashian Concrete

CA

Greg Hilson

NJ

GOLDEN TRIANGLE TAX AND ACCOUNTING

MS

Kensington Audiology, LLC

MD

TMSS, LLC dba Paradeco Coffee Roasters

FL

E.C Electric LLC

OR

Jugaar Corporation

TX

Burcon LLC

FL

blade real estate inspections

WA

Master Fire & Mechanical Contractors Inc.

NY

Espinoza Cleaning Service LLC

CT

Seer Information Technology, Inc.

VA

BLUE HAMMER CONTRACTOR SERVICES LLC

TX

Tibbs Turf Lawn Care

KY

D2 Services, LLC

TX

Steam Kings

FL

TEK-Logic LLC

TX

South Country Home Inspections Inc

FL

CHARLES ANDERSON MD

MA

GeonomicsPW

MI

ZP JUAN CONSTRUCTION INC

CA

Interexpress Usa LLC

TX

Mike Tax Pro

CA

The Kitchen Ronin

PA

Home System Services

LA

J.T.C TRIM LLC

TX

J.T.C TRIMM LLC

TX

bobs lawyer

SD

Dukes Pressure Washing

TX

Athena Constructions Inc

MI

Global Systems Design

WI

Modular plus installation

CA

Stevenson cleaning service

TX

A Better Solution

KS

Mathematica Radhey Research

FL

Jeff Willits dba Jeff Willits Floors

CA

Global Executive Solutions LLC

FL

Perfecut Landscape Management, LLC

TN

Rich Embrace Media, LLC

TX

Haines Electric, Inc.

OH

The Super Tech

TN

MG CUSTOMS LLC

CO

Harmon Mechanical LLC

AL

HVAC Services

MD

South Pine Gift Co

WA

Esq Construction and remodeling LLC

TX

David J. Young LLC

MD

Palmetto Resolutions of the Carolinas, LLC

NC

Remobility LLC

FL

CITA

AZ

C & D Home Inspection

TX

C & D Home Inspections

TX

Bournes Communications Concepts LLC

MD

3RD LETTER VENTURES LLC

TX

young's window cleaning

MI

Sani Shield Cleaning Services

TX

Rhythm Renovations LLC

HI

Crest Medical Search

TX

Tim's Plumbing

WI

J&V Flooring and Carpet Installation

IA

Travis Mackin LLC

KY

Know Noy's Services LLC

NV

Hancock Appliance Repair

MA

Lozano Flooring

CA

Climate Control

CO

Amman Consulting LLC

TX

Coen's Pressure Washing

WA

MT GONZALEZ ACCOUNTING SERVICES

FL

Pishband Catering LLC

TX

Termeh Bakery, LLC.

TX

Versally Inc.

MD

National Garage Door Inc Of Houston

TX

Scoops Ice Cream

GA

Pasteur Water System

FL

Two Generations LLC d/b/a Two Generations Custom Staining
and Painting

FL

Montanaro Consulting

SC

30243024

Did this page help you?