# Stream Chat API

**Provider:** Stream
**Category:** communication
**Base URL:** `https://chat.stream-io-api.com`
**Auth:** api-key — `GET /app?api_key=YOUR_API_KEY`
**Rate Limit:** See documentation
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://getstream.io/chat/docs/

## Description

In-app messaging and real-time chat API supporting channel management, message history, moderation, reactions, and user presence for web and mobile apps.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://chat.stream-io-api.com/app` | Get app settings |
| GET | `https://chat.stream-io-api.com/channels` | Query channels |
| POST | `https://chat.stream-io-api.com/channels/{type}/{id}/message` | Send a message |
| GET | `https://chat.stream-io-api.com/channels/{type}/{id}/messages` | Get messages |
| GET | `https://chat.stream-io-api.com/users` | Query users |
| POST | `https://chat.stream-io-api.com/moderation/ban` | Ban a user |
| GET | `https://chat.stream-io-api.com/blocklists` | List block lists |
| POST | `https://chat.stream-io-api.com/blocklists` | Create a block list |

## Authentication

API key passed as a query parameter (api_key)

```
GET /app?api_key=YOUR_API_KEY
```

## Sample Request

```bash
curl -X GET 'https://chat.stream-io-api.com/app?api_key=YOUR_API_KEY'
```

## Sample Response

```json
{"app":{"name":"My App","suspended":false,"webhook_url":"https://example.com/hook"}}
```

## Pricing Details

Free tier for development; paid plans scale by message volume and MAUs.

---

*Source: [API Map](https://apimap.dev/apis/stream-chat/) — CC BY 4.0*