# API addresses

> Every satellite's API addresses for production and staging in one table, and which ones have a short alias on api.bifrostorbit.com.

Source: https://docs.bifrostorbit.com/orbit/developers/api-addresses/

Bifröst Orbit has two hosts for each stage:

| Host | Production | Staging |
| --- | --- | --- |
| The app, every satellite and their APIs | `app.bifrostorbit.com` | `stage.bifrostorbit.com` |
| Short addresses for website APIs | `api.bifrostorbit.com` | `api-stage.bifrostorbit.com` |

Staging is a separate copy, with its own organisations, data and keys. A production key doesn't work on staging.

## Every address

Swap `app.` for `stage.` and `api.` for `api-stage.` to reach staging.

| Satellite | API | Address |
| --- | --- | --- |
| CMS Orbit | Delivery API | `https://api.bifrostorbit.com/cms/v1` |
| | GraphQL | `https://api.bifrostorbit.com/cms/graphql` |
| | Management API | `https://api.bifrostorbit.com/cms/manage/v1` |
| | Preview and the editing bridge | `https://api.bifrostorbit.com/cms/preview`, `https://api.bifrostorbit.com/cms/bridge.js` |
| | Images and files | `https://api.bifrostorbit.com/cms/uploads/…` |
| | MCP server | `https://app.bifrostorbit.com/cms/mcp` |
| Careers Orbit | Delivery API | `https://api.bifrostorbit.com/careers/v1` |
| | GraphQL | `https://api.bifrostorbit.com/careers/graphql` |
| | Management API | `https://app.bifrostorbit.com/careers/api/v1` |
| | MCP server | `https://app.bifrostorbit.com/careers/mcp` |
| Commerce Orbit | Storefront API | `https://app.bifrostorbit.com/commerce/api/public/{shop address}` |
| | GraphQL | `https://app.bifrostorbit.com/commerce/api/cdn/graphql` |
| | MCP server | `https://app.bifrostorbit.com/commerce/mcp` |
| Travel Orbit | Booking API | `https://app.bifrostorbit.com/travel/api/public/{booking name}` |
| | GraphQL | `https://app.bifrostorbit.com/travel/api/cdn/graphql` |
| | MCP server | `https://app.bifrostorbit.com/travel/mcp` |
| Booking Orbit | Public booking API | `https://app.bifrostorbit.com/booking/api/public/{location's booking name}` |
| | MCP server | `https://app.bifrostorbit.com/booking/mcp` |
| Presence Orbit | Review widget | `https://app.bifrostorbit.com/presence/api/public/{business name}/reviews` |
| | Review requests | `https://app.bifrostorbit.com/presence/api/v1/organisations/{organisationId}/requests` |
| | MCP server | `https://app.bifrostorbit.com/presence/mcp` |
| Insights Orbit | Script, events, server API and raw event API | `https://api.bifrostorbit.com/insights/v1/` |
| | GraphQL | `https://api.bifrostorbit.com/insights/graphql` |
| | MCP server | `https://app.bifrostorbit.com/insights/mcp` |

The shop address, the booking names and the Presence business name are set in each satellite's settings, such as `northwilds` or `northwilds-oslo`.

Opening `https://api.bifrostorbit.com/` shows the main addresses as JSON. An address that doesn't exist answers `404` with `not_found`.

## Aliases on the app host

The short addresses on `api.` are aliases. Each also works on the app host under the satellite's own path, and the delivery APIs on the `api.` host also answer at that path:

| Short address | Same as |
| --- | --- |
| `api.bifrostorbit.com/cms/v1/…` | `app.bifrostorbit.com/cms/api/cdn/v1/…` and `api.bifrostorbit.com/cms/api/cdn/v1/…` |
| `api.bifrostorbit.com/cms/graphql` | `app.bifrostorbit.com/cms/api/cdn/graphql` |
| `api.bifrostorbit.com/cms/manage/v1/…` | `app.bifrostorbit.com/cms/api/v1/…` |
| `api.bifrostorbit.com/careers/v1/…` | `app.bifrostorbit.com/careers/api/cdn/v1/…` |
| `api.bifrostorbit.com/careers/graphql` | `app.bifrostorbit.com/careers/api/cdn/graphql` |
| `api.bifrostorbit.com/insights/graphql` | `app.bifrostorbit.com/insights/api/cdn/graphql` |

Use the short addresses in your code: they are the ones the SDKs and the satellites' docs use. A redirect between them, such as a trailing slash added to an endpoint, costs a second request: leave the trailing slash off API endpoints.

Commerce, Travel, Booking and Presence Orbit have no short addresses on `api.` yet: call them on the app host.

## Orbit itself

Orbit has no public API. Its mobile API, at `app.bifrostorbit.com/api/mobile/v1`, is only for the Orbit app. See [Sign in with Orbit](https://docs.bifrostorbit.com/orbit/developers/sign-in-with-orbit/). Orbit Exchange, at `api.bifrostorbit.com/exchange/v1`, only answers the satellites. See [Orbit Exchange](https://docs.bifrostorbit.com/orbit/developers/orbit-exchange/).

## When a service is restarting

While a satellite restarts, for example during an update, its API answers `503` with `unavailable` and `Retry-After: 15`. Wait and try again. [Status](https://docs.bifrostorbit.com/status/) shows each satellite's health.
