> For the complete documentation index, see [llms.txt](https://api.docs.fan/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.docs.fan/profile/readme.md).

# Home

The Profile API lets you read and manage a customer's profile: favorite teams and leagues, preferences, emails, and Fanatics credit card information.

To interact with our profile endpoints you must authenticate the user according to the [FanaticsID](https://api.docs.fan/) documentation. Then you can use the access token from the [Code Exchange](/web-sso-fanidui/code-exchange.md) as the `Authorization` header to gain access to the endpoints.

## Available Endpoints

| Path                                  | Notes                                                                                                  |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `/v2/profile/{ID}/favorites`          | Read and add favorite teams and leagues for a profile.                                                 |
| `/v2/profile/{ID}/preferences`        | Read and update profile preferences (preferred name, language, t-shirt size, FanaticsONE opt-in, ...). |
| `/v2/profile/{ID}/creditcard`         | Read Fanatics credit card (Imprint) information for a profile.                                         |
| `/v2/profile/{ID}/creditcard/streaks` | Read Fanatics credit card streak information for a profile.                                            |

## Legacy Endpoints

The original v1 FanID account endpoints are still available. Prefer the v2 profile endpoints above; use these only for account fields not yet available in v2 (login email, phone, address, 2FA settings).

| Path       | Notes                                                                               |
| ---------- | ----------------------------------------------------------------------------------- |
| `/v1/{ID}` | Read or update the FanID account (name, login email, phone, address, 2FA settings). |

## Coming Soon

The following profile service capabilities are not yet exposed through the gateway. They are documented here ahead of time so you can plan your integration — paths and payloads may change slightly when they are made available externally.

| Capability   | Notes                                                                                                                        |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| Profile core | Read, update, and delete a profile (name, birthday, age range). Creation happens as part of the broader account create flow. |
| Emails       | List, add, and delete a profile's email addresses, and set the primary email.                                                |

> Note: Profile endpoints inherently process Personally Identifiable Information (names, emails, ...). Only submit PII in the fields that are explicitly designed for it, and handle all responses according to your data-protection agreements with Fanatics.