> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flynet.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the calling 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](/api-reference/payments/create) without waiting on
the onboarding email. The same `flynet_merchant_id` identifies your app's
reward wallet — the one [`balance`](/api-reference/rewards/balance) reports and
[`issue_reward`](/api-reference/rewards/issue) draws from.

Auth: API key in `X-API-Key`. The key must carry the `read:app` scope.

## Example

```bash theme={null}
curl "https://api.staging.blackbird.xyz/flynet/v1/app" \
  -H "X-API-Key: $API_KEY"
```

## Response

```json theme={null}
{
  "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`. |