Get the calling app

curl --request GET \
  --url https://api.staging.blackbird.xyz/flynet/v1/app

const options = {method: 'GET'};

fetch('https://api.staging.blackbird.xyz/flynet/v1/app', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET'};

fetch('https://api.staging.blackbird.xyz/flynet/v1/app', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

GET

app

Get the calling app

curl --request GET \
  --url https://api.staging.blackbird.xyz/flynet/v1/app

const options = {method: 'GET'};

fetch('https://api.staging.blackbird.xyz/flynet/v1/app', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET'};

fetch('https://api.staging.blackbird.xyz/flynet/v1/app', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Returns the calling application’s own record — its flynet_merchant_id, allowed_scopes, owning account, and status. The app is resolved from the API key, so there is no ID in the path. Use it to look up your flynet_merchant_id for payment-intent creation without waiting on the onboarding email. The same flynet_merchant_id identifies your app’s reward wallet — the one balance reports and issue_reward draws from. Auth: API key in X-API-Key. The key must carry the read:app scope.

Example

curl "https://api.staging.blackbird.xyz/flynet/v1/app" \
  -H "X-API-Key: $API_KEY"

Response

{
  "id": "7b3c6d8e-0f12-4a5b-8c9d-1e2f3a4b5c6d",
  "object": "app",
  "name": "Corner Suite",
  "flynet_merchant_id": "2c8f0e5a-1d4b-4c9e-9f2a-7b3c6d8e0f12",
  "allowed_scopes": ["read:app", "read:checkins", "read:profile", "read:wallets"],
  "active": true,
  "created_at": "2026-05-07T18:18:31.078859Z",
  "account": {
    "id": "9a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "company_name": "Corner Suite, Inc.",
    "contact_email": "dev@cornersuite.example"
  }
}

Field	Type	Notes
`id`	UUID	Your app’s client ID.
`flynet_merchant_id`	UUID	Pass this when creating payment intents.
`allowed_scopes`	array	Scopes this app may grant to its keys and tokens.
`account`	object	The owning developer account: `id`, `company_name`, `contact_email`.

Introduction Get my profile

Overview

App

Users

Restaurants

Locations

Check-ins

Challenges

Specials

Memberships

Payments

Rewards

Get the calling app

Example

Response

​Example

​Response

Example

Response