--- updatedAt: 2026-06-05T13:06:03.000Z agentTools: projectIndex: https://ribbon.readme.io/llms.txt --- # Search Organizations Search for different organizations. #### Example Use Case Display a map of all of all nearby health systems and their relevant information so that a patient can find care. # 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/organizations": { "get": { "summary": "Search Organizations", "description": "Search for different organizations.\n\n#### Example Use Case\nDisplay a map of all of all nearby health systems and their relevant information so that a patient can find care.\n", "operationId": "getOrganizations", "tags": [ "Organizations" ], "parameters": [ { "name": "address", "in": "query", "required": false, "description": "String input of an address that will be interpreted and geocoded in real time.", "schema": { "type": "string", "example": "New York, NY" } }, { "name": "name", "in": "query", "required": false, "description": "String input that is fuzzy matched to against the `organization.name` field.", "schema": { "type": "string", "example": "baptist" } }, { "name": "distance", "in": "query", "required": false, "description": "Constrains the search to within this many miles of the center point", "schema": { "type": "integer", "example": 10 } }, { "name": "location", "in": "query", "required": false, "description": "Latitude/longitude pair of coordinates in lieu of a string address.", "schema": { "type": "string", "example": "37.7489816,-122.4802092" } }, { "$ref": "#/paths/~1v1~1procedures/get/parameters/2" }, { "$ref": "#/paths/~1v1~1procedures/get/parameters/3" } ], "responses": { "200": { "description": "Specialties returned from a valid request", "content": { "application/json": { "schema": { "type": "object", "required": [ "parameters", "data" ], "properties": { "parameters": { "type": "object", "properties": { "page": { "type": "integer", "example": 1, "description": "The page of the results which was returned." }, "page_size": { "type": "integer", "example": 25, "description": "How many results are in each page." }, "total_count": { "type": "integer", "example": 141, "description": "The total number of results matched, across all pages." }, "sort_by": { "type": "string", "example": "distance", "description": "The main criteria used to sort results in the record set." }, "distance": { "type": "integer", "example": 10, "description": "The proximity radius of locations returned." }, "geo": { "type": "object", "properties": { "latitude": { "type": "number", "example": 40.7351327, "description": "The latitude the search was focused on." }, "longitude": { "type": "number", "example": -73.9881657, "description": "The longitude the search was focused on." } } }, "address": { "type": [ "string", "null" ], "description": "String input of an address that will be interpreted and geocoded in real time.", "example": "Jacksonville, FL, USA" }, "name": { "type": "string", "description": "String input that is fuzzy matched to against the `organization.name` field.", "example": "baptist" } } }, "data": { "type": "array", "items": { "$ref": "#/paths/~1v1~1custom~1organizations~1%7Borganization_uuid%7D/get/responses/200/content/application~1json/schema" } } } } } } } } } }, "/v1/procedures": { "get": { "summary": "Search Procedures", "description": "Search and list procedures that exist within the Ribbon API.\n", "operationId": "getProcedures", "tags": [ "Reference Endpoints" ], "parameters": [ { "$ref": "#/paths/~1v1~1languages/get/parameters/0" }, { "name": "procedure_code", "in": "query", "required": false, "description": "A specific billing code (e.g., CPT, DRG) to search for", "schema": { "type": "string", "example": 73222 } }, { "name": "page", "in": "query", "required": false, "description": "The page of the results which was returned.", "schema": { "type": "integer", "example": 1 } }, { "name": "page_size", "in": "query", "required": false, "description": "How many results are in each page.", "schema": { "type": "integer", "example": 15 } } ], "responses": { "200": { "description": "Procedures returned from a valid request", "content": { "application/json": { "schema": { "type": "object", "required": [ "count", "next", "previous", "results" ], "properties": { "count": { "type": "integer", "description": "The total number of results matched, across all pages.", "example": 141 }, "next": { "type": [ "string", "null" ], "example": "https://api.ribbonhealth.com/v1/procedures?page=3" }, "previous": { "type": [ "string", "null" ], "example": "https://api.ribbonhealth.com/v1/procedures?page=1" }, "results": { "type": "array", "items": { "type": "object", "properties": { "uuid": { "type": "string", "format": "uuid", "example": "0a9a245f-2f52-4cc0-a5c3-77a811acc6f7", "description": "A UUID uniquely identifying this procedure" }, "display_name": { "type": "string", "example": "MRI, arm" } } } } } } } } } } } } }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer" } } }, "security": [ { "BearerAuth": [] } ] } ```