Place of Service Codes API

Look up CMS Place of Service (POS) codes that identify where healthcare services were rendered.

Overview

Place of Service (POS) codes are two-digit codes maintained by CMS that indicate the setting where a healthcare service was provided. These codes are required on CMS-1500 professional claims (field 24B) and are used in reimbursement determination, utilization analysis, and compliance auditing. FHIRfly provides fast lookups against the current CMS POS code set, including a list endpoint that returns all active codes.

Endpoints

Method	Path	Description
GET	`/v1/pos/:code`	Single POS code lookup
POST	`/v1/pos/_batch`	Batch lookup (up to 100)
GET	`/v1/pos/list`	List all POS codes (~52 codes)
GET	`/v1/pos/shapes`	List available response shapes

Single Lookup

Look up Place of Service 11 (Office)

Request

Node.js

const response = await fetch(
  "https://api.fhirfly.io/v1/pos/11",
  {
    method: "GET",
    headers: {
    "x-api-key": "YOUR_API_KEY",
  }
  }
);

const data = await response.json();
console.log(data);

Response

JSON

{
  "data": {
    "code": "11",
    "name": "Office",
    "description": "Location, other than a hospital, skilled nursing facility (SNF), military treatment facility, community health center, State or local public health clinic, or intermediate care facility (ICF), where the health professional routinely provides health examinations, diagnosis, and treatment of illness or injury on an ambulatory basis.",
    "effective_date": "2003-01-01"
  },
  "meta": {
    "legal": {
      "license": "public_domain",
      "attribution_required": false,
      "source_name": "CMS Place of Service Codes"
    }
  }
}

Common POS Codes

Code	Name	Description
11	Office	Physician or practitioner office
21	Inpatient Hospital	Acute care inpatient facility
22	On Campus-Outpatient Hospital	Hospital outpatient department
23	Emergency Room - Hospital	Emergency department
31	Skilled Nursing Facility	SNF for skilled care
81	Independent Laboratory	Freestanding laboratory facility
02	Telehealth Provided Other than in Patient's Home	Telehealth services
10	Telehealth Provided in Patient's Home	Home telehealth

Batch Lookup

Look up multiple POS codes in a single request (up to 100):

Look up multiple POS codes

Request

Node.js

const response = await fetch(
  "https://api.fhirfly.io/v1/pos/_batch",
  {
    method: "POST",
    headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
    body: JSON.stringify({
    "codes": [
      "11",
      "21",
      "23"
    ]
  })
  }
);

const data = await response.json();
console.log(data);

Response

JSON

{
  "count": 3,
  "results": [
    {
      "input": "11",
      "code": "11",
      "status": "ok",
      "data": {
        "name": "Office",
        "description": "Location, other than a hospital, skilled nursing facility (SNF), military treatment facility, community health center, State or local public health clinic, or intermediate care facility (ICF), where the health professional routinely provides health examinations, diagnosis, and treatment of illness or injury on an ambulatory basis."
      }
    },
    {
      "input": "21",
      "code": "21",
      "status": "ok",
      "data": {
        "name": "Inpatient Hospital",
        "description": "A facility, other than psychiatric, which primarily provides diagnostic, therapeutic (both surgical and nonsurgical), and rehabilitation services by, or under, the supervision of physicians to patients admitted for a variety of medical conditions."
      }
    },
    {
      "input": "23",
      "code": "23",
      "status": "ok",
      "data": {
        "name": "Emergency Room - Hospital",
        "description": "A portion of a hospital where emergency diagnosis and treatment of illness or injury is provided."
      }
    }
  ],
  "meta": {
    "legal": {
      "license": "public_domain"
    }
  }
}

List All Codes

The list endpoint returns all active POS codes (~52 codes). This is useful for populating dropdowns or validation lists:

GET /v1/pos/list

{
  "data": [
    { "code": "01", "name": "Pharmacy" },
    { "code": "02", "name": "Telehealth Provided Other than in Patient's Home" },
    { "code": "03", "name": "School" },
    { "code": "04", "name": "Homeless Shelter" },
    { "code": "05", "name": "Indian Health Service Free-standing Facility" },
    { "code": "11", "name": "Office" },
    { "code": "21", "name": "Inpatient Hospital" },
    { "code": "22", "name": "On Campus-Outpatient Hospital" },
    { "code": "23", "name": "Emergency Room - Hospital" }
  ],
  "total": 52,
  "meta": {
    "legal": {
      "license": "public_domain",
      "attribution_required": false,
      "source_name": "CMS Place of Service Codes"
    }
  }
}

Response Shapes

Control the level of detail in responses with the shape query parameter:

Shape	Description
`compact`	Code, name
`standard`	+ description, effective date (default)
`full`	+ ingest metadata, provenance

# Minimal data
GET /v1/pos/11?shape=compact

# Standard data (default)
GET /v1/pos/11?shape=standard

# Full data with provenance
GET /v1/pos/11?shape=full

See Response Shapes for field details.

Required Scopes

pos.read - Single, batch, and list lookups