# OneSignal API

**Provider:** OneSignal
**Category:** developer
**Base URL:** `https://api.onesignal.com`
**Auth:** api-key — `Authorization: Bearer YOUR_TOKEN`
**Rate Limit:** 10× your total subscriptions per 15-min window
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://documentation.onesignal.com/docs/onesignal-api

## Description

Self-serve customer engagement solution for Push Notifications, Email, SMS & In-App

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.onesignal.com/apps` | View apps |
| POST | `https://api.onesignal.com/apps` | Create an app |
| GET | `https://api.onesignal.com/apps/{app_id}` | View an app |
| PUT | `https://api.onesignal.com/apps/{app_id}` | Update an app |
| POST | `https://api.onesignal.com/players/csv_export` | Export subscriptions CSV |
| POST | `https://api.onesignal.com/notifications/{message_id}/history` | Message history |
| POST | `https://api.onesignal.com/apps/{app_id}/segments` | Create segment |
| GET | `https://api.onesignal.com/apps/{app_id}/segments` | View segments |

## Authentication

See documentation for auth details

```
Authorization: Bearer YOUR_TOKEN
```

## Sample Request

```bash
curl 'https://documentation.onesignal.com'
```

## Sample Response

```json
{}
```

## Pricing Details

Free: unlimited subscribers (push), core messaging. Growth $19/mo + usage: advanced targeting, A/B testing. Mobile push billed at $0.012/MAU.

---

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