Platform // Developer API

API Reference.

Build custom integrations, automate content workflows, and control your screens programmatically with the Hangar.Media REST API.

API Reference

Build custom integrations with the Hangar.Media REST API.

See It In Action Sign Up

Getting Started

Authentication

All API requests require authentication via Bearer token. Include your API key in the Authorization header of every request.

Example Request

curl -X GET "https://api.hangar.media/v1/screens" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

API Key

Generate keys in your dashboard under Settings > API. Each key can be scoped to specific permissions.

OAuth 2.0

For third-party integrations, use the OAuth 2.0 authorization code flow with PKCE.

API Reference

Base URL: https://api.hangar.media/v1

Screens

Method Path Description
GET /screens List all screens
POST /screens Create a screen
GET /screens/{id} Get screen details
PUT /screens/{id} Update a screen
DELETE /screens/{id} Delete a screen

Content

Method Path Description
GET /content List all content
POST /content Upload content
DELETE /content/{id} Delete content

Schedules

Method Path Description
GET /schedules List schedules
POST /schedules Create a schedule
POST /schedules/{id}/assign Assign schedule to screens

Rate Limits

Request Limits

Tier Limit Burst
Standard 100 req/min 200 req/min
Read endpoints 200 req/min 400 req/min
Write endpoints 60 req/min 120 req/min
Upload 30 req/min 60 req/min

Rate limit headers: X-RateLimit-Remaining, X-RateLimit-Reset

Webhooks

Event Types

Receive real-time notifications when events occur in your account.

screen.online
screen.offline
content.published
content.deleted
playlist.updated
schedule.activated
alert.triggered

Example Payload

{
  "event": "screen.online",
  "timestamp": "2026-03-29T14:30:00Z",
  "data": {
    "screen_id": "scr_01JARW8K9BXYZ",
    "name": "Lobby Display",
    "status": "online",
    "ip_address": "192.168.1.42"
  }
}
H.

Chat

Online

How can we help?

Choose an option to get started