Get the calling app
curl --request GET \
--url https://api.staging.blackbird.xyz/flynet/v1/appconst 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));App
Get the calling app
GET
/
app
Get the calling app
curl --request GET \
--url https://api.staging.blackbird.xyz/flynet/v1/appconst 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. |