# Streamer profile

**`GET /v1/streamer`** · Secret or public key · scope `profile:read`

Your public profile: nickname, name, avatar and the donation page link.

## Responses

- `200` — OK
- `400` — A parameter is invalid, or the key was sent in the request address: [`invalid_parameter`](https://developers.donatty.com/en/errors/invalid_parameter.md), [`token_in_query`](https://developers.donatty.com/en/errors/token_in_query.md)
- `401` — The key is missing, unknown, deleted or expired: [`missing_token`](https://developers.donatty.com/en/errors/missing_token.md), [`invalid_token`](https://developers.donatty.com/en/errors/invalid_token.md), [`token_expired`](https://developers.donatty.com/en/errors/token_expired.md)
- `403` — Wrong kind of key, the key lacks the `profile:read` scope, or the public key came from an address that is not in its list: [`wrong_token_type`](https://developers.donatty.com/en/errors/wrong_token_type.md), [`insufficient_scope`](https://developers.donatty.com/en/errors/insufficient_scope.md), [`origin_not_allowed`](https://developers.donatty.com/en/errors/origin_not_allowed.md)
- `429` — Rate limit exceeded: [`rate_limited`](https://developers.donatty.com/en/errors/rate_limited.md)
- `500` — The request failed on our side: [`internal_error`](https://developers.donatty.com/en/errors/internal_error.md)
- `503` — The API is temporarily unavailable: [`service_unavailable`](https://developers.donatty.com/en/errors/service_unavailable.md)

## Example response

```json
{
  "id": "str_5b0c2f4e-8d61-4f43-9a7e-2f1d3c6b9a10",
  "slug": "teststreamer",
  "displayName": "Test Streamer",
  "avatarUrl": "https://storage.donatty.com/avatars/teststreamer.png",
  "donatePageUrl": "https://donatty.com/teststreamer"
}
```

## Schemas

### Streamer

| Field | Type | Description |
|---|---|---|
| `id` | string | Streamer identifier, `str_…`. |
| `slug` | string | Nickname: the last part of the donation page address. |
| `displayName` | string | The name donors see. |
| `avatarUrl` | string (URI) or null | Avatar link; `null` when there is no avatar. |
| `donatePageUrl` | string (URI) | Donation page link. |
