> ## Documentation Index
> Fetch the complete documentation index at: https://285e39fd5e337e58f16290.sightscreen.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Users

> User profile, account, and follow sync endpoints.

## Endpoint reference

| Method | Route           | Auth | Purpose                        |
| ------ | --------------- | ---- | ------------------------------ |
| `GET`  | `/me`           | User | Get authenticated user profile |
| `GET`  | `/user/follows` | User | List followed match IDs        |

***

### GET /me `User`

Returns the authenticated user's profile.

```json theme={null}
{
  "userId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "phone": "+61400000000",
  "isAdmin": false,
  "followedMatches": ["match-001", "match-002"]
}
```

***

### GET /user/follows `User`

Returns the list of match IDs the authenticated user is currently following. The iOS app calls this on launch to sync local follow state with the backend.

<Tabs>
  <Tab title="Request">
    ```
    GET /user/follows
    ```
  </Tab>

  <Tab title="Response (200)">
    ```json theme={null}
    {
      "follows": [
        {
          "matchId": "match-001",
          "teamId": "team-1",
          "followedAt": "2026-03-15T10:30:00Z"
        },
        {
          "matchId": "match-002",
          "teamId": null,
          "followedAt": "2026-03-16T14:00:00Z"
        }
      ]
    }
    ```
  </Tab>
</Tabs>

<Note>
  This endpoint is lightweight and designed to be called on every app launch. It returns only the follow records, not full match data. The app should use the match IDs to fetch match details separately.
</Note>