Partner API Reference

Integrate your CMS, programmatic ad servers, or custom digital sign hardware with FairAds AI APIs.

FairAds AI provides REST APIs and Webhook integrations for media owners to programmatically manage inventory, fetch playback logs, and receive real-time booking alerts.

Authentication

All API requests require an API key passed in the request header:

Authorization: Bearer fa_partner_live_8a92b3c4d5e6...

Key API Endpoints

1. List All Inventory Screens

GET /v1/partner/screens

Response Example

{
  "status": "success",
  "data": [
    {
      "id": "scr_90124",
      "name": "Downtown Plaza Billboard #1",
      "status": "ONLINE",
      "resolution": "1920x1080",
      "operating_hours": "06:00-23:00",
      "active_loop_items": 6
    }
  ]
}

2. Submit Play Log Batch (Proof of Performance)

POST /v1/partner/screens/{screen_id}/play-logs

Webhooks

Subscribe to real-time events in Manage > Settings > Webhooks:

booking.created
creative.approved
screen.offline_alert