---
updatedAt: 2026-06-05T13:06:03.000Z
agentTools:
  projectIndex: https://ribbon.readme.io/llms.txt
---

# Get Clinical Area

Retrieve data on a specific clinical area.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "H1's API",
    "version": "1.0.0",
    "description": "An API for interacting with the data provided by Ribbon Health, including information about healthcare providers,\nlocations, insurances, and more.\n\n## Price Transparency v2\n\nLocation-first negotiated rate endpoints live under `/v2/*` (separate from legacy\n`/v1/pricing/*`). Use them to:\n\n1. Look up procedures, care clusters, and carriers (`GET /v2/procedures`,\n   `/v2/care-clusters`, `/v2/carriers`)\n2. Get prices for a known location (`GET /v2/locations/{location_id}/pricing/...`)\n3. Shop by geography (`GET /v2/pricing/locations/...`)\n\n**Key differences from v1:** prices are location-scoped (not provider-first);\ncarriers use string business ids (not v1 carrier UUIDs); every v2 response uses\nthe same envelope (`parameters`, `total_count`, `page`, `page_size`, `data`);\ngeo search requires an explicit `address` or `lat`+`lng` (no silent default).\n\nSee the **Price Transparency v2** tag for full endpoint reference.\n"
  },
  "servers": [
    {
      "url": "https://api.ribbonhealth.com"
    }
  ],
  "paths": {
    "/v1/custom/clinical_areas/{clinical_area_uuid}": {
      "get": {
        "summary": "Get Clinical Area",
        "description": "Retrieve data on a specific clinical area.\n",
        "operationId": "getClinicalArea",
        "tags": [
          "Focus Area Endpoints"
        ],
        "parameters": [
          {
            "name": "clinical_area_uuid",
            "in": "path",
            "required": true,
            "description": "The UUID of the target clinical area.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "f352b596-dfb0-494f-9a03-224794f5d182"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a single clinical area",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "uuid": {
                      "type": "string",
                      "format": "uuid",
                      "example": "f352b596-dfb0-494f-9a03-224794f5d182",
                      "description": "A UUID uniquely identifying this clinical area"
                    },
                    "display": {
                      "type": "string",
                      "example": "Substance Disorders (e.g. Opioid, Cocaine, Alcohol)"
                    },
                    "types": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "providers",
                          "locations"
                        ]
                      }
                    },
                    "conditions": {
                      "type": "array",
                      "items": {
                        "$ref": "#/paths/~1v1~1custom~1conditions~1%7Bcondition_uuid%7D/get/responses/200/content/application~1json/schema"
                      }
                    },
                    "treatments": {
                      "type": "array",
                      "items": {
                        "$ref": "#/paths/~1v1~1custom~1treatments~1%7Btreatment_uuid%7D/get/responses/200/content/application~1json/schema"
                      }
                    },
                    "specialties": {
                      "type": "array",
                      "items": {
                        "$ref": "#/paths/~1v1~1custom~1specialties~1%7Bspecialty_uuid%7D/get/responses/200/content/application~1json/schema"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "The given clinical area UUID cannot be found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1v1~1custom~1tin~1%7Btin_id%7D/get/responses/404/content/application~1json/schema"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "security": [
    {
      "BearerAuth": []
    }
  ]
}
```