---
title: "GET /bridge/catalog"
method: GET
path: "/bridge/catalog"
tags: ["bridge"]
---

# GET /bridge/catalog

`GET /bridge/catalog`

Get branding & metadata information associated with healthcare institutions supported by Fasten Connect. 

`brand_id` OR `portal_id` is required.

<Note>
This is used to display branding information in the Stitch.js popup widget.
This API not required, unless you are building a custom widget.
</Note>

<Warning>
**Do not call this endpoint live on every request.**

Fasten may occasionally merge or deprecate IDs when the source EHR data changes or deletes records. To avoid broken references and improve performance:

- Cache the results returned by this endpoint.
- To check for updates, use the `org_connection_id` to call the [status endpoint](/api-reference/organization_connection/get) and retrieve the current `brand_id` and `portal_id`.
- Then, use those values to query the catalog GET endpoint and update your cached results accordingly.

Following this pattern ensures you always have the latest data without risking failures from deprecated IDs.
</Warning>

<Badge color="green">TEFCA</Badge> If `tefca_directory_id` and `brand_id` are available, you should retrieve both. `tefca_directory_id` will provide an accurate name for the Healthcare Provider, while the `brand_id` can be used for logos and other branding information. However, if you can only retrieve one, prioritize `tefca_directory_id`.

TEFCA Directory IDs are subject to change by the TEFCA governing body and may be deprecated without notice. TEFCA Directory IDs are only cached for 2 weeks, after which they are removed from the catalog.

## Query parameters

- `api_mode` string, required
- `public_id` string, required
- `portal_id` string
- `brand_id` string
- `tefca_directory_id` string

## Response `200`

successful operation

- object
  - `success` boolean
  - `error` string
  - `data` union
    - object — Patient Portal information for a healthcare institution
      - `id` string, uuid
      - `last_updated` string, date-time
      - `name` string
      - `portal_website` string, uri
      - `description` string
      - `endpoint_ids` string[]
    - object — Branding information for a healthcare institution
      - `id` string, uuid
      - `last_updated` string, date-time
      - `name` string
      - `brand_website` string, uri
      - `aliases` string[]
      - `description` string
      - `portal_ids` string[]
      - `brand_ids` string[]

---

[API](https://skmtc.net/fastenhealth/apis/fasten-connect-2.md) · [All operations](https://skmtc.net/fastenhealth/apis/fasten-connect-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fastenhealth/fasten-connect-2/versions/800c22d7994f/schema)