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

# Get Organization

Retrieve detailed information for any organization given its UUID


# 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/{organization_uuid}": {
      "get": {
        "summary": "Get Organization",
        "description": "Retrieve detailed information for any organization given its UUID\n",
        "operationId": "getOrganization",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "organization_uuid",
            "in": "path",
            "required": true,
            "description": "The UUID of the target organization.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "a1dbf998-a65b-4780-8361-648357785d96"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The requested organization is returned",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "uuid": {
                      "type": "string",
                      "format": "uuid",
                      "example": "a1dbf998-a65b-4780-8361-648357785d96",
                      "description": "A UUID uniquely identifying this organization"
                    },
                    "name": {
                      "type": "string",
                      "example": "Baptist Health (Jacksonville)"
                    },
                    "organization_types": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "Health System"
                        ]
                      },
                      "description": "The types of this organization. We currently only support `Health System` organizations, but plan to expand this in the future"
                    },
                    "websites": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "example": "https://www.baptistjax.com/"
                          }
                        }
                      },
                      "description": "Website(s) of this organization"
                    },
                    "ids": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "example": "5"
                          },
                          "id_type": {
                            "type": "string",
                            "example": "AHA_ID"
                          }
                        }
                      }
                    },
                    "address": {
                      "type": "string",
                      "example": "841 Prudential Dr # 1601, Jacksonville, FL 32207, US"
                    },
                    "address_details": {
                      "type": "object",
                      "properties": {
                        "zip": {
                          "type": "string",
                          "example": "32207"
                        },
                        "city": {
                          "type": "string",
                          "example": "Jacksonville"
                        },
                        "state": {
                          "type": "string",
                          "example": "FL"
                        },
                        "street": {
                          "type": "string",
                          "example": "841 Prudential Dr # 1601"
                        },
                        "address_line_1": {
                          "type": "string",
                          "example": "841 Prudential Dr"
                        },
                        "address_line_2": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "example": "# 1601"
                        }
                      }
                    },
                    "latitude": {
                      "type": "number",
                      "example": 30.3159499
                    },
                    "longitude": {
                      "type": "number",
                      "example": 81.6630919
                    },
                    "phone_numbers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "phone": {
                            "type": "string",
                            "example": "9042022000"
                          },
                          "detail": {
                            "type": "string",
                            "example": "primary"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "The given 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": []
    }
  ]
}
```