> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connect.fastenhealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk Catalog Export

> Retrieve download links for the entire Fasten Connect catalog in one request.

Call this endpoint with your bridge API credentials (HTTP Basic auth using the `public_id` and `private_key`) whenever you need to hydrate an offline cache of our catalog.

Instead of iterating through the `/bridge/catalog` lookup endpoint, this API returns pre-signed URLs for JSON files that contain the entire public catalog:

* `brands.json` – Logos, names, TEFCA directory metadata, and other display properties for each brand.
* `portals.json` – Portal definitions, including login methods and the brands they belong to.
* `endpoints.json` – Technical endpoint configuration, such as FHIR base URLs, TEFCA IAS capability flags, and supported auth flows.

<Warning>
  The download URLs expire after 60 minutes. Begin downloading the files immediately after requesting them.

  This API is rate limited and the brand, portal and endpoint data structure is subject to change without notice.

  **Please contact [support@fastenhealth.com](mailto:support@fastenhealth.com) before use.**
</Warning>

```json theme={null}
{
  "brands.json": "https://fasten-connect-cdn-prod-1234/catalog/2024-06-28/brands.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=60&...",
  "portals.json": "https://fasten-connect-cdn-prod-1234/catalog/2024-06-28/portals.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=60&...",
  "endpoints.json": "https://fasten-connect-cdn-prod-1234/catalog/2024-06-28/endpoints.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=60&..."
}
```


## OpenAPI

````yaml GET /bridge/catalog/export
openapi: 3.0.1
info:
  title: Fasten Connect
  description: >-
    Useful links:

    - [Fasten Connect API
    repository](https://github.com/fastenhealth/fasten-connect-api)

    - [Fasten Connect Developer
    Portal](https://github.com/fastenhealth/fasten-connect-app)
  termsOfService: https://www.fastenhealth.com/
  contact:
    email: connect@fastenhealth.com
  license:
    name: Private
  version: 1.0.11
servers:
  - url: https://api.connect.fastenhealth.com/v1/
    description: Use this server for both live and test mode.
security: []
tags:
  - name: auth
    description: Portal Authentication & Signup
  - name: user
    description: Operations about user
  - name: org
    description: Operations about organization
  - name: bridge
    description: Customer (organization) facing APIs
  - name: catalog
    description: Catalog APIs
externalDocs:
  description: Find out more about Fasten Connect
  url: https://www.fastenhealth.com/
paths:
  /bridge/catalog/export:
    get:
      tags:
        - bridge
      description: >-
        Download the full Fasten Connect catalog in bulk. This endpoint returns
        URLs for JSON files that contain all brands, portals, and endpoints that
        are currently available in our catalog.


        Use this API when you need to hydrate or refresh an offline cache
        instead of repeatedly calling the catalog lookup endpoints.


        <Warning>

        The download URLs expire after 60 minutes. Begin downloading the files
        immediately after requesting them.


        This API is rate limited and the data structure is subject to change.
        **Please contact support@fastenhealth.com before use.**

        </Warning>
      responses:
        '200':
          description: Download URLs for each catalog file
          content:
            application/json:
              schema:
                type: object
                properties:
                  brands.json:
                    type: string
                    format: uri
                    description: Bulk metadata for every brand supported by Fasten Connect.
                    example: >-
                      https://fasten-connect-cdn-prod-1234/catalog/2024-06-28/brands.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=60&...
                  portals.json:
                    type: string
                    format: uri
                    description: >-
                      Bulk metadata for every portal supported by Fasten
                      Connect.
                    example: >-
                      https://fasten-connect-cdn-prod-1234/catalog/2024-06-28/portals.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=60&...
                  endpoints.json:
                    type: string
                    format: uri
                    description: >-
                      Bulk metadata for every endpoint supported by Fasten
                      Connect.
                    example: >-
                      https://fasten-connect-cdn-prod-1234/catalog/2024-06-28/endpoints.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=60&...
      security:
        - bridge_basic: []
components:
  securitySchemes:
    bridge_basic:
      type: http
      scheme: basic
      description: >
        [Basic Authentication](/api-reference/authentication), containing API
        Public Id and Private Key generated from the Fasten Connect Portal. **Do
        not expose these keys in the browser.**

````