curl --request POST \
--url https://sandbox.rcintell.com/v1/facilities \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"ccn": "170001",
"city": "Topeka",
"facility_type": "short_term_acute",
"is_rural": false,
"name": "Acme General Hospital",
"npi": "1234567890",
"pos_code": "22",
"state": "KS",
"zip_code": "66601"
}
'import requests
url = "https://sandbox.rcintell.com/v1/facilities"
payload = {
"ccn": "170001",
"city": "Topeka",
"facility_type": "short_term_acute",
"is_rural": False,
"name": "Acme General Hospital",
"npi": "1234567890",
"pos_code": "22",
"state": "KS",
"zip_code": "66601"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ccn: '170001',
city: 'Topeka',
facility_type: 'short_term_acute',
is_rural: false,
name: 'Acme General Hospital',
npi: '1234567890',
pos_code: '22',
state: 'KS',
zip_code: '66601'
})
};
fetch('https://sandbox.rcintell.com/v1/facilities', 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.rcintell.com/v1/facilities",
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([
'ccn' => '170001',
'city' => 'Topeka',
'facility_type' => 'short_term_acute',
'is_rural' => false,
'name' => 'Acme General Hospital',
'npi' => '1234567890',
'pos_code' => '22',
'state' => 'KS',
'zip_code' => '66601'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$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.rcintell.com/v1/facilities"
payload := strings.NewReader("{\n \"ccn\": \"170001\",\n \"city\": \"Topeka\",\n \"facility_type\": \"short_term_acute\",\n \"is_rural\": false,\n \"name\": \"Acme General Hospital\",\n \"npi\": \"1234567890\",\n \"pos_code\": \"22\",\n \"state\": \"KS\",\n \"zip_code\": \"66601\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
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.rcintell.com/v1/facilities")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ccn\": \"170001\",\n \"city\": \"Topeka\",\n \"facility_type\": \"short_term_acute\",\n \"is_rural\": false,\n \"name\": \"Acme General Hospital\",\n \"npi\": \"1234567890\",\n \"pos_code\": \"22\",\n \"state\": \"KS\",\n \"zip_code\": \"66601\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.rcintell.com/v1/facilities")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ccn\": \"170001\",\n \"city\": \"Topeka\",\n \"facility_type\": \"short_term_acute\",\n \"is_rural\": false,\n \"name\": \"Acme General Hospital\",\n \"npi\": \"1234567890\",\n \"pos_code\": \"22\",\n \"state\": \"KS\",\n \"zip_code\": \"66601\"\n}"
response = http.request(request)
puts response.read_body{
"ccn": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"is_active": true,
"name": "<string>",
"address_line1": "<string>",
"cbsa": "<string>",
"cbsa_detail": {
"cbsa_code": "<string>",
"cbsa_name": "<string>",
"county_fips": "<string>",
"county_name": "<string>",
"is_metropolitan": true
},
"certifications": [
"<string>"
],
"city": "<string>",
"county": "<string>",
"facility_type": "<string>",
"gpci": {
"locality_name": "<string>",
"locality_number": "<string>",
"mp_gpci": 123,
"pe_gpci": 123,
"pw_gpci": 123,
"year": 123
},
"is_rural": true,
"mac": {
"jurisdiction": "<string>",
"mac_id": "<string>",
"mac_name": "<string>",
"mac_number": "<string>",
"phone": "<string>",
"website": "<string>"
},
"npi": "<string>",
"pos_code": "<string>",
"resolved_layers": {},
"state": "<string>",
"zip_code": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"ctx": {},
"input": "<unknown>"
}
]
}Register a facility
Register a new healthcare facility by CCN.
The CCN (Medicare Provider Number) is parsed to automatically determine the facility’s state, facility type, and payment system. Each CCN must be unique within a tenant.
curl --request POST \
--url https://sandbox.rcintell.com/v1/facilities \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"ccn": "170001",
"city": "Topeka",
"facility_type": "short_term_acute",
"is_rural": false,
"name": "Acme General Hospital",
"npi": "1234567890",
"pos_code": "22",
"state": "KS",
"zip_code": "66601"
}
'import requests
url = "https://sandbox.rcintell.com/v1/facilities"
payload = {
"ccn": "170001",
"city": "Topeka",
"facility_type": "short_term_acute",
"is_rural": False,
"name": "Acme General Hospital",
"npi": "1234567890",
"pos_code": "22",
"state": "KS",
"zip_code": "66601"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ccn: '170001',
city: 'Topeka',
facility_type: 'short_term_acute',
is_rural: false,
name: 'Acme General Hospital',
npi: '1234567890',
pos_code: '22',
state: 'KS',
zip_code: '66601'
})
};
fetch('https://sandbox.rcintell.com/v1/facilities', 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.rcintell.com/v1/facilities",
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([
'ccn' => '170001',
'city' => 'Topeka',
'facility_type' => 'short_term_acute',
'is_rural' => false,
'name' => 'Acme General Hospital',
'npi' => '1234567890',
'pos_code' => '22',
'state' => 'KS',
'zip_code' => '66601'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$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.rcintell.com/v1/facilities"
payload := strings.NewReader("{\n \"ccn\": \"170001\",\n \"city\": \"Topeka\",\n \"facility_type\": \"short_term_acute\",\n \"is_rural\": false,\n \"name\": \"Acme General Hospital\",\n \"npi\": \"1234567890\",\n \"pos_code\": \"22\",\n \"state\": \"KS\",\n \"zip_code\": \"66601\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
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.rcintell.com/v1/facilities")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ccn\": \"170001\",\n \"city\": \"Topeka\",\n \"facility_type\": \"short_term_acute\",\n \"is_rural\": false,\n \"name\": \"Acme General Hospital\",\n \"npi\": \"1234567890\",\n \"pos_code\": \"22\",\n \"state\": \"KS\",\n \"zip_code\": \"66601\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.rcintell.com/v1/facilities")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ccn\": \"170001\",\n \"city\": \"Topeka\",\n \"facility_type\": \"short_term_acute\",\n \"is_rural\": false,\n \"name\": \"Acme General Hospital\",\n \"npi\": \"1234567890\",\n \"pos_code\": \"22\",\n \"state\": \"KS\",\n \"zip_code\": \"66601\"\n}"
response = http.request(request)
puts response.read_body{
"ccn": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"is_active": true,
"name": "<string>",
"address_line1": "<string>",
"cbsa": "<string>",
"cbsa_detail": {
"cbsa_code": "<string>",
"cbsa_name": "<string>",
"county_fips": "<string>",
"county_name": "<string>",
"is_metropolitan": true
},
"certifications": [
"<string>"
],
"city": "<string>",
"county": "<string>",
"facility_type": "<string>",
"gpci": {
"locality_name": "<string>",
"locality_number": "<string>",
"mp_gpci": 123,
"pe_gpci": 123,
"pw_gpci": 123,
"year": 123
},
"is_rural": true,
"mac": {
"jurisdiction": "<string>",
"mac_id": "<string>",
"mac_name": "<string>",
"mac_number": "<string>",
"phone": "<string>",
"website": "<string>"
},
"npi": "<string>",
"pos_code": "<string>",
"resolved_layers": {},
"state": "<string>",
"zip_code": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"ctx": {},
"input": "<unknown>"
}
]
}Authorizations
Body
Register a new healthcare facility.
6-digit Medicare Provider Number (CCN)
^\d{6}$"170001"
Facility display name
1 - 255"Acme General Hospital"
Street address line 1
255Street address line 2
255Core Based Statistical Area code (auto-derived if omitted)
10Facility licensures/certifications that can drive payer rules, e.g. ['oasas_licensed', 'omh_licensed'].
["oasas_licensed"]
City
100"Topeka"
County name
100"Shawnee"
Facility type — short_term_acute, asc, rhc, fqhc, ipf, irf, ltch, etc. Drives the facility/non-facility PE-RVU choice.
64Pre-computed CMS rural indicator. Drives DME rural/non-rural rate selection.
10-digit National Provider Identifier
^\d{10}$"1234567890"
Default place-of-service code (e.g. '11' office, '22' on-campus outpatient hospital)
^\d{2}$2-letter state code
^[A-Z]{2}$"KS"
ZIP code
^\d{5}(-\d{4})?$"66601"
Response
Created facility profile
Facility profile with resolved knowledge layers.
Medicare Provider Number
Facility display name
Core Based Statistical Area code
CBSA metro area detail
Show child attributes
Show child attributes
Facility licensures/certifications that can drive payer rules.
short_term_acute, asc, rhc, fqhc, ipf, ...
GPCI locality factors
Show child attributes
Show child attributes
CMS rural indicator (DME rate selection)
Medicare Administrative Contractor
Show child attributes
Show child attributes
National Provider Identifier
Default place-of-service code
Cached L1-L6 knowledge layer data