SeatsBrokers – Broker API

1. Overview

The SeatsBrokers API allows approved brokers to authenticate, publish seat inventory, manage orders, and receive real-time lifecycle webhooks.

Base URL: https://api.seatsbrokers.com/v1

2. Broker Authentication

POST /auth/broker/token

{
  "broker_key": "BRK-92A8X",
  "broker_secret": "**************"
}

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
  "token_type": "Bearer",
  "expires_in": 3600
}

3. Broker Account

GET /broker/account

{
  "broker_id": "BRK-92A8X",
  "status": "active",
  "company_name": "Example Broker LLC",
  "currency": "USD"
}

4. Inventory APIs

POST /inventory/create

{
  "inventory_ref": "INV-88921",
  "event_ref": "EVT-55401",
  "seat_section": "Premium",
  "seat_row": "B",
  "seat_numbers": ["5","6"],
  "quantity": 2,
  "ask_price": 520.00,
  "currency": "USD"
}

Response

{
  "status_code": "INV_ACCEPTED",
  "tracking_ref": "TRK-550192",
  "received_at": "2026-06-01T10:22:11Z"
}

5. Bulk Inventory Upload

POST /inventory/bulk-upload

{
  "batch_ref": "BATCH-9011",
  "items": [
    {"inventory_ref":"INV-1","ask_price":450,"quantity":2},
    {"inventory_ref":"INV-2","ask_price":600,"quantity":1}
  ]
}

6. Order APIs

POST /orders/create

{
  "inventory_ref": "INV-88921",
  "order_ref": "ORD-77341",
  "final_price": 540.00
}

Webhook Response

{
  "order_status": "confirmed",
  "settlement_state": "pending"
}

7. Webhook Events

8. Error Codes