Blackbird · Authentication Profile

Blackbird Authentication

Authentication

Flynet uses two credentials for two route families, never interchangeable: an X-API-Key (fly_live_/fly_test_) for Discovery routes (/restaurants*, /locations*, /check_ins feed), and an OAuth 2.0 + PKCE bearer JWT for member routes (/users/me/*) and all payment intent routes. The spec models the bearer as http/JWT; the OAuth flow and scopes are documented in scopes/blackbird-scopes.yml.

Blackbird secures its APIs with apiKey and http across 2 declared security schemes, as derived from its OpenAPI definitions.

CompanyRestaurantsLoyaltyPaymentsDiningMembershipCryptoBlockchainWeb3
Methods: apiKey, http Schemes: 2 OAuth flows: API key in: header

Security Schemes

oauthBearer http
scheme: bearer
apiKey apiKey
· in: header (X-API-Key)

Source

Authentication Profile

Raw ↑ 
generated: '2026-07-18'
method: searched
source: openapi/blackbird-flynet-openapi-original.yml
docs: https://docs.flynet.org/concepts/authentication
description: >-
  Flynet uses two credentials for two route families, never interchangeable:
  an X-API-Key (fly_live_/fly_test_) for Discovery routes (/restaurants*,
  /locations*, /check_ins feed), and an OAuth 2.0 + PKCE bearer JWT for member
  routes (/users/me/*) and all payment intent routes. The spec models the bearer
  as http/JWT; the OAuth flow and scopes are documented in
  scopes/blackbird-scopes.yml.
summary:
  types:
  - apiKey
  - http
  api_key_in:
  - header
  oauth_variant: OAuth 2.0 + PKCE (Token-Mediating Backend)
schemes:
- name: oauthBearer
  type: http
  scheme: bearer
  bearerFormat: JWT
  description: |-
    OAuth 2.0 access token. Required for the `/users/me/*` routes
    (profile, status, wallets, tags, check-ins, memberships) and all
    payment intent routes.
  sources:
  - openapi/blackbird-flynet-openapi-original.yml
- name: apiKey
  type: apiKey
  in: header
  parameter: X-API-Key
  description: |-
    Server-to-server API key prefixed `fly_live_...` (production) or
    `fly_test_...` (staging/dev). Required on restaurant and location
    Discovery routes and on the `/check_ins` venue feed (key minted
    with `read:checkins`).
  sources:
  - openapi/blackbird-flynet-openapi-original.yml