Get an OSHA inspection
curl --request GET \
--url https://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}', 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://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}",
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://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}"
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://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}")
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{
"activityNr": "<string>",
"reportingId": "<string>",
"stateFlag": "<string>",
"estabName": "<string>",
"siteAddress": "<string>",
"siteCity": "<string>",
"siteState": "<string>",
"siteZip": "<string>",
"ownerType": "<string>",
"ownerCode": "<string>",
"advNotice": "<string>",
"safetyHlth": "<string>",
"sicCode": "<string>",
"naicsCode": "<string>",
"inspType": "<string>",
"inspScope": "<string>",
"whyNoInsp": "<string>",
"unionStatus": "<string>",
"safetyManuf": "<string>",
"safetyConst": "<string>",
"safetyMarit": "<string>",
"healthManuf": "<string>",
"healthConst": "<string>",
"healthMarit": "<string>",
"migrant": "<string>",
"mailStreet": "<string>",
"mailCity": "<string>",
"mailState": "<string>",
"mailZip": "<string>",
"hostEstKey": "<string>",
"nrInEstab": 123,
"openDate": "<string>",
"caseModDate": "<string>",
"closeConfDate": "<string>",
"closeCaseDate": "<string>",
"ldDt": "<string>",
"id": "<string>",
"employerId": "<string>",
"siteId": "<string>",
"sourceFile": {
"url": "<string>",
"sha256": "<string>",
"retrievedAt": "<string>"
}
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}OSHA
Get an OSHA inspection
OSHA enforcement inspections, from the Department of Labor’s enforcement data. OSHA’s rows as published, under OSHA’s own column names in camelCase. Each row also carries the employerId and siteId Effective matched it to (null if unmatched) and the OSHA file it came from. Needs the OSHA dataset enabled for your organization. Read-only; private, no-store.
GET
/
insurance
/
osha
/
inspections
/
{activityNr}
Get an OSHA inspection
curl --request GET \
--url https://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}', 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://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}",
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://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}"
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://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.canary.effectiveai.app/api/v2/insurance/osha/inspections/{activityNr}")
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{
"activityNr": "<string>",
"reportingId": "<string>",
"stateFlag": "<string>",
"estabName": "<string>",
"siteAddress": "<string>",
"siteCity": "<string>",
"siteState": "<string>",
"siteZip": "<string>",
"ownerType": "<string>",
"ownerCode": "<string>",
"advNotice": "<string>",
"safetyHlth": "<string>",
"sicCode": "<string>",
"naicsCode": "<string>",
"inspType": "<string>",
"inspScope": "<string>",
"whyNoInsp": "<string>",
"unionStatus": "<string>",
"safetyManuf": "<string>",
"safetyConst": "<string>",
"safetyMarit": "<string>",
"healthManuf": "<string>",
"healthConst": "<string>",
"healthMarit": "<string>",
"migrant": "<string>",
"mailStreet": "<string>",
"mailCity": "<string>",
"mailState": "<string>",
"mailZip": "<string>",
"hostEstKey": "<string>",
"nrInEstab": 123,
"openDate": "<string>",
"caseModDate": "<string>",
"closeConfDate": "<string>",
"closeCaseDate": "<string>",
"ldDt": "<string>",
"id": "<string>",
"employerId": "<string>",
"siteId": "<string>",
"sourceFile": {
"url": "<string>",
"sha256": "<string>",
"retrievedAt": "<string>"
}
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic",
"accessUrl": "<string>"
}Authorizations
Effective API key. Send Authorization: Bearer sk-eai-...
Path Parameters
Inspection activity number.
Pattern:
^\d{1,12}$Response
One inspection.
One OSHA enforcement inspection. Fields are OSHA’s own column names in camelCase, with values as OSHA publishes them.
The inspection’s activity number.
Employer Effective matched this row to, or null if it could not place it.
Pattern:
^emp_[0-9a-f]{20}$Site Effective matched this row to, or null.
Pattern:
^site_[0-9a-f]{20}$Show child attributes
Show child attributes