Skip to main content
GET
/
app
Get the calling app
curl --request GET \
  --url https://api.staging.blackbird.xyz/flynet/v1/app
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. 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"
  }
}
FieldTypeNotes
idUUIDYour app’s client ID.
flynet_merchant_idUUIDPass this when creating payment intents.
allowed_scopesarrayScopes this app may grant to its keys and tokens.
accountobjectThe owning developer account: id, company_name, contact_email.