API Reference

This section contains the technical reference for the Fyre Partner API.

The API provides a single, consistent interface for partners to exchange data with the Fyre platform. It is used to deliver transactional data to Fyre and to access selected partner-facing features for connected outlets, such as challenges and other activation or insight capabilities.

This page explains the overall scope of the API, how it is organized, and key concepts that apply across all endpoints. Detailed endpoint documentation is provided in the sections that follow.

API environment and access

All API requests use the production Fyre API environment.

Base URL https://api.fyre.app

The API is versioned using a path-based versioning scheme. All endpoints documented in this section use the /api/v1/ prefix.

Access to the API is managed by Fyre. Partners are granted access as part of the integration process, and usage is limited to the agreed scope. Details about authentication are covered in .

Purpose of the API

The Fyre API serves as the primary technical interface between partner systems and the Fyre platform.

Through the API, partners can:

• Deliver transactional data during the preparation phase and in production

• Provide historical transactional data where applicable

• Retrieve partner-facing information for their outlets

• Participate in activation and challenge-based features as they are enabled

The same API integration is used throughout the lifecycle of the partnership. While the set of available endpoints may expand over time, the integration surface and authentication model remain consistent.

Outlet identification

The fyre_id is the canonical identifier used to represent outlets within the Fyre platform.

Each outlet connected by a partner is assigned a unique fyre_id when it is onboarded into the Fyre system. This identifier uniquely represents an outlet across all Fyre products, APIs, and analytics, while preserving anonymity.

Key characteristics of fyre_id:

• It is generated and managed by Fyre

• It uniquely identifies a single outlet within the Fyre platform

• It does not contain any personally identifiable or business-identifying information

• It is stable over time and does not change for the lifetime of the outlet

The fyre_id is used across the API to reference outlets in a consistent and anonymized way. Most transactional and partner-facing endpoints use fyre_id as the primary outlet reference.

After the preparation phase, Fyre shares the assigned fyre_id values with the partner as part of the enriched outlet list. Partners are expected to store and reuse these identifiers when interacting with the API.