> ## 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 my status

Returns the authenticated member's membership status: their tier,
benefits, and progress toward the next level. The subject is resolved
from the access token, so there is no member ID in the path.

<Note>
  **Tasting note** - `tier` is a display string and may contain a
  newline (e.g. `"$FLY\nwith us"`). Render the break or strip it, but don't
  treat it as a flat label.
</Note>

<Tip>
  **From the kitchen** - `progress.*_threshold` is the bar to clear to
  advance; the matching `progress.*` value is where the member stands
  now. Pair them for a progress bar.
</Tip>

Auth: OAuth access token with the `read:profile` scope. A token
missing that scope returns `403` with `error="insufficient_scope"` in
the `WWW-Authenticate` header. A member with no active status record
returns `404` with `code: "resource_not_found"`.

## Example

```bash theme={null}
curl https://api.staging.blackbird.xyz/flynet/v1/users/me/status \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

## Response

```json theme={null}
{
  "id": "54245b01-5de2-4608-91d3-be7ddabf28ea",
  "object": "status",
  "user": "be9caffa-7f30-462a-b7ab-9cca9edb8ab8",
  "tier": "$FLY\nwith us",
  "level": 1,
  "track": "regular",
  "fly_multiplier": 3,
  "state": "active",
  "benefits": [
    { "title": "Dining Points", "description": "Earn 3X on Blackbird Pay." },
    { "title": "Coffee Club", "description": "Earn 10X points at all Blackbird coffee shops." }
  ],
  "progress": {
    "check_ins": 1,
    "check_in_threshold": 0,
    "spend": { "value": 0, "currency": "usd" },
    "spend_threshold": { "value": 0, "currency": "usd" },
    "fly_deposit": { "value": "0", "currency": "fly" },
    "fly_deposit_threshold": { "value": "0", "currency": "fly" }
  },
  "year_start": 1767225600,
  "year_end": 1798761600,
  "started_at": "2026-05-12T18:06:00.660572Z",
  "created_at": "2026-05-12T18:06:00.665635Z",
  "updated_at": "2026-05-12T18:06:00.665646Z"
}
```

## Schema

| Field            | Type               | Notes                                                                                                                                              |
| ---------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`             | UUID               | Status record ID.                                                                                                                                  |
| `object`         | string             | Always `"status"`.                                                                                                                                 |
| `user`           | UUID               | The member's ID (the token `sub`).                                                                                                                 |
| `tier`           | string             | Display string; may contain `\n`.                                                                                                                  |
| `level`          | integer            | `1` to `7`.                                                                                                                                        |
| `track`          | string             | `regular` or `pro`.                                                                                                                                |
| `fly_multiplier` | integer            | Points multiplier for the member's track.                                                                                                          |
| `state`          | string             | One of `active`, `expired`, `replaced`, `deactivated`.                                                                                             |
| `benefits`       | array              | Each item is `{ title, description }`.                                                                                                             |
| `progress`       | object             | `check_ins` / `check_in_threshold` (integers), `spend` / `spend_threshold` (USD cents), `fly_deposit` / `fly_deposit_threshold` (FLY wei strings). |
| `year_start`     | integer            | **Unix epoch seconds**, not an ISO string.                                                                                                         |
| `year_end`       | integer            | **Unix epoch seconds**, not an ISO string.                                                                                                         |
| `started_at`     | ISO 8601 timestamp | When this status period began.                                                                                                                     |
| `created_at`     | ISO 8601 timestamp | Created time.                                                                                                                                      |
| `updated_at`     | ISO 8601 timestamp | Last update time.                                                                                                                                  |

## See also

* [Money and tokens](/concepts/money-and-tokens): how FLY wei strings and USD cents are encoded.
* [List memberships](/api-reference/memberships/list): per-restaurant check-in counts and tiers.