Skip to main content

Viewtron IP Camera HTTP API

Viewtron IP cameras and NVRs expose an HTTP API for programmatic access to device configuration, live video, PTZ control, AI detection settings, alarm management, and real-time event webhooks. The API uses XML payloads over HTTP POST requests with Basic Authentication.

All AI inference runs on the camera hardware — no cloud service, external software, or per-device licensing required. All Viewtron products are NDAA compliant.

What You Can Do​

  • Receive real-time AI detection webhooks — HTTP POST events when cameras detect humans, vehicles, faces, or license plates, with snapshot images and bounding box coordinates
  • Control PTZ cameras — pan, tilt, zoom, focus, presets, cruise tours
  • Track objects continuously — real-time target position data via traject streaming at ~7 updates/sec
  • Read and capture license plates — LPR with plate database management and gate access control via Wiegand
  • Detect and recognize faces — face detection with attributes (age, sex, glasses, mask) and face matching
  • Count people and vehicles — entrance/exit counting by line or area with statistics
  • Configure AI detection zones — intrusion zones, line crossing, region entry/exit, loitering, parking violations
  • Capture snapshots — live JPEG snapshots and time-based recording search via RTSP
  • Control alarm outputs — trigger relays, sirens, and strobe lights programmatically
  • Query device status — model info, firmware version, disk capacity, channel configuration

Quick Example​

import requests
from requests.auth import HTTPBasicAuth

# Query camera info
response = requests.get(
    "http://192.168.0.50/GetDeviceInfo",
    auth=HTTPBasicAuth("admin", "password123")
)
print(response.text)

# Move a PTZ camera
requests.get(
    "http://192.168.0.50/PtzControl/1/ZoomIn",
    auth=HTTPBasicAuth("admin", "password123")
)

Applicable Products​

All Viewtron IP cameras and Viewtron NVRs support this API. See Supported Products for a complete list with per-product API capabilities.

Quick Start​

  1. Authenticate — all requests use Basic Authentication
  2. Test connectivity — send a GetDeviceInfo request to verify access
  3. Explore Applications — browse solution guides to see what you can build
  4. Reference endpoints — find detailed request/response docs in the API Reference

Resources​

  • Python API Server & Library — github.com/mikehaldas/IP-Camera-API — working webhook receiver with the viewtron.py abstraction library that handles all API version differences
  • Markdown Documentation — all documentation pages are available as Markdown files in the GitHub docs directory for easy integration with AI coding assistants and automated tools
  • Single-File Reference — the complete API documentation in one searchable file for quick reference and AI assistant ingestion
  • Support Forum — NVR Webhook Setup Guide

Questions & Development Inquiries​

Mike Haldas is available for questions, consultation, and custom software development for Viewtron API related projects. Email details about your project to mike@viewtron.com.