---
title: "Join Fare Group"
method: POST
path: "/auth/fare-group"
tags: ["auth"]
---

# Join Fare Group

`POST /auth/fare-group`

## Request

- Base URL: `https://api.helloaxel.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.helloaxel.com/auth/fare-group`
- Auth: none declared

## Headers

- `X-Axel-Flight-Source` string, nullable
- `X-Axel-Flight-Source-Signature` string, nullable

## Request body

- FareGroupSignupRequest
  - `id` string, uuid, required
  - `email` string, email, required
  - `timezone` string, nullable
  - `tracking` InternalTrackingData: Tracking data sent FROM THE GATEWAY to the users service. Combines frontend-sent data with server-extracted request metadata.
    - `meta` MetaTrackingData: Meta-specific tracking data sent from the frontend.
      - `fbp` string, nullable
      - `fbc` string, nullable
      - `event_id` string, nullable
    - `attribution` AttributionData: First, latest, and separately preserved latest paid attribution.
      - `first_touch` AttributionTouch: A single captured attribution touch.
        - `attribution_version` integer
        - `captured_at` string, date-time, nullable
        - `landing_path` string, nullable
        - `referrer_path` string, nullable
        - `capture_state` 'observed_no_referrer', nullable
        - `utm_source` string, nullable
        - `utm_medium` string, nullable
        - `utm_campaign` string, nullable
        - `utm_content` string, nullable
        - `utm_term` string, nullable
        - `utm_id` string, nullable
        - `utm_adgroup` string, nullable
        - `utm_asset_group` string, nullable
        - `utm_creative` string, nullable
        - `utm_content_id` string, nullable
        - `utm_placement` string, nullable
        - `fbclid` string, nullable
        - `twclid` string, nullable
        - `ttclid` string, nullable
        - `oppref` string, nullable
        - `gclid` string, nullable
        - `gbraid` string, nullable
        - `wbraid` string, nullable
        - `partnership_code` string, nullable
        - `transaction_id` string, nullable
        - `creative_id` string, nullable
      - `last_touch` AttributionTouch: A single captured attribution touch.
        - `attribution_version` integer
        - `captured_at` string, date-time, nullable
        - `landing_path` string, nullable
        - `referrer_path` string, nullable
        - `capture_state` 'observed_no_referrer', nullable
        - `utm_source` string, nullable
        - `utm_medium` string, nullable
        - `utm_campaign` string, nullable
        - `utm_content` string, nullable
        - `utm_term` string, nullable
        - `utm_id` string, nullable
        - `utm_adgroup` string, nullable
        - `utm_asset_group` string, nullable
        - `utm_creative` string, nullable
        - `utm_content_id` string, nullable
        - `utm_placement` string, nullable
        - `fbclid` string, nullable
        - `twclid` string, nullable
        - `ttclid` string, nullable
        - `oppref` string, nullable
        - `gclid` string, nullable
        - `gbraid` string, nullable
        - `wbraid` string, nullable
        - `partnership_code` string, nullable
        - `transaction_id` string, nullable
        - `creative_id` string, nullable
      - `last_paid_touch` AttributionTouch: A single captured attribution touch.
        - `attribution_version` integer
        - `captured_at` string, date-time, nullable
        - `landing_path` string, nullable
        - `referrer_path` string, nullable
        - `capture_state` 'observed_no_referrer', nullable
        - `utm_source` string, nullable
        - `utm_medium` string, nullable
        - `utm_campaign` string, nullable
        - `utm_content` string, nullable
        - `utm_term` string, nullable
        - `utm_id` string, nullable
        - `utm_adgroup` string, nullable
        - `utm_asset_group` string, nullable
        - `utm_creative` string, nullable
        - `utm_content_id` string, nullable
        - `utm_placement` string, nullable
        - `fbclid` string, nullable
        - `twclid` string, nullable
        - `ttclid` string, nullable
        - `oppref` string, nullable
        - `gclid` string, nullable
        - `gbraid` string, nullable
        - `wbraid` string, nullable
        - `partnership_code` string, nullable
        - `transaction_id` string, nullable
        - `creative_id` string, nullable
    - `user_agent` string, nullable
    - `ip_address` string, nullable
    - `event_source_url` string, nullable
  - `entry_message` string, required
  - `consent` true, required
  - `session_id` string, uuid, nullable
  - `trip_reference` string, required
  - `request_scope` 'search' | 'selection', required
  - `booking_token` string, nullable
  - `search_choices` FlightSearchChoices
    - `airline` string, nullable
    - `max_stops` integer, nullable
    - `outbound` FlightSearchLegChoices
      - `stops` 'nonstop' | 'one' | 'twoPlus', nullable
      - `airline_only` string, nullable
      - `avoided_airlines` string[]
    - `returning` FlightSearchLegChoices
      - `stops` 'nonstop' | 'one' | 'twoPlus', nullable
      - `airline_only` string, nullable
      - `avoided_airlines` string[]
    - `fare_preferences` FlightFarePreferences: Stated needs for this party; None is unstated, never a requirement.
      - `seat_selection` boolean, nullable
      - `carry_on` boolean, nullable
      - `checked_bags` integer, nullable: Checked bags needed per ticketed traveler, on each direction.
      - `changes` boolean, nullable
      - `refunds` boolean, nullable

## Response `200`

Successful Response

- FareGroupSignupResponse
  - `status` 'saved' | 'login_required', required
  - `trip_id` string, nullable
  - `resume_token` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 82 revisions in range; 1 not diffed.

- **2026-10-23** `3ef5a4d221d7`: 2 info
  - added the new optional request property `booking_token`
  - added the new optional request property `search_choices`
- **2026-10-22** `3f9a3f4ed5a6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/auth/fare-group/post.md)

---

[API](https://skmtc.dev/helloaxel/apis/client-api-gateway.md) - [All operations](https://skmtc.dev/helloaxel/apis/client-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/helloaxel/apis/client-api-gateway/revisions/5d2bae0deed4?raw)