LogoLogo
🛠️ Tools🗂️ SDK📄 White Paper
  • Getting Started
    • 🟣What is NDI?
    • 🆕Release Notes
    • 📄White Paper
      • Discovery & Registration
        • mDNS
        • Discovery Service
        • Manual Connection
        • NDI Groups
      • NDI Protocols
        • Reliable UDP - NDI 5
        • Multipath TCP - NDI 4
        • UDP with Forward Error Correction – NDI 3
        • Single TCP – NDI 1
      • NDI Related Network Ports
      • Getting video across the network
      • Network Layout
      • Bandwidth
        • NDI High Bandwidth based on SpeedHQ2 (8bit 4:2:2)
        • NDI High Bandwidth based on SpeedHQ7 (8bit 4:2:2:4)
        • NDI HX2 h.264 (8bit 4:2:0)
        • NDI HX2 h.265 (8bit 4:2:0)
        • NDI HX3 h.264 (8bit 4:2:0)
        • NDI HX3 h.265 (8bit 4:2:0)
        • NDI Proxy and bandwidth optimization
      • Network Interface Settings
      • NIC Selection
      • Encoding and Decoding
      • Multicast
      • NDI Administrative Settings
      • Synchronization
      • NDI in the Cloud
    • Glossary
      • NDI Terminology
      • Industry Terminology
  • Using NDI
    • Introduction
    • NDI for Video
      • Digital Video Basics
      • NDI Video Codecs and Format Matrix
      • NDI Encoding Support Matrix
        • Practical NDI Receivers Format Support
        • Practical NDI Transmitters Support
        • Summary Table
      • Interoperability Scenarios
    • NDI for Audio
      • Digital Audio Fundamentals
      • Audio Over IP
      • Technical Facts About NDI for Audio
      • Use Cases
      • Products Using NDI for Audio
    • ⚒️NDI Tools
      • Release Notes
      • Installing NDI Tools
        • Software License Agreement
        • Privacy Policy
      • NDI Tools Launcher
      • NDI Tools for Windows
        • Access Manager
        • Bridge
          • NDI Bridge automation
          • Configuring Port Forwarding
          • Bridge Tool Logging
        • Remote
        • Router
        • Screen Capture
        • Screen Capture HX
        • Studio Monitor
        • Test Patterns
        • Webcam Input
      • NDI Tools for Mac
        • Access Manager
        • Scan Converter
        • Router
        • Test Patterns
        • Video Monitor
        • Virtual Input
      • Plugins
        • NDI for After Effects
        • NDI for Premiere Pro
        • NDI Output for Final Cut Pro
        • NDI for VLC
        • Audio Direct
        • OBS
    • Utilities
      • Analysis
    • Using NDI with Software
      • Getting Started with NDI in OBS for Windows or Mac
      • Using OBS Studio as a Commentary System
      • Using NDI Tools as a virtual camera in Mac
      • Using NDI and Dante on the same Network
      • Use OBS video + audio on Zoom with macOS
    • Using NDI with Hardware
      • NDI HX upgrades for cameras
      • How to Activate Panasonic Cameras for NDI HX1 — Step-by-Step
      • Recommended Network Switch Settings for NDI
  • Developing with NDI
    • Introduction
    • 📂SDK
      • Release Notes
      • Licensing
      • Software Distribution
        • Header Files
        • Binary Files
        • Redistributables
        • Content Files
        • Libraries
        • NDI-SEND
        • NDI-FIND
        • NDI-RECEIVE
        • Utilities
        • Command Line Tools
      • CPU Requirements
      • Dynamic Loading of NDI Libraries
      • Performance and Implementation
      • Startup and Shutdown
      • Example Code
      • Port Numbers
      • 🔧Configuration Files
      • Platform Considerations
      • NDI-SEND
      • NDI-FIND
      • NDI-RECV
      • NDI Routing
      • HDR
      • Command Line Tools
      • Frame Types
        • Video Frames
        • Audio Frames
        • Metadata Frames
      • Windows DirectShow Filter
      • 3rd Party Rights
      • Support
    • Advanced SDK
      • Release Notes
      • Licensing
      • Overview
      • Configuration Files
      • NDI SDK Review
        • Sending
          • Asynchronous Sending Completions
          • NDI Sending On High Latency Connections
        • Receiving
          • Custom Allocators
            • Video Allocators
            • Audio Allocators
          • Dynamic Bandwidth Adjustment
        • Finding
        • Video Formats
          • Receiver Codec Support Level
          • Frame Synchronization
      • Genlock
      • AV Sync
        • Guidelines
        • Creating and Destroying Devices
        • Recovering Audio
      • Using H.264, H.265, and AAC Codecs
        • Sending Audio Frames
        • Sending Video Frames
        • H.264 Support
        • H.265 Support
        • AAC Support
        • OPUS Support
        • Latency of Compressed Streams
        • Stream Validation
      • External Tally Support
      • KVM Support
      • NDI Advanced SDK FPGA Example Designs
        • Prebuilt uSD Images
        • NDI FPGA Reference Design
          • FPGA Projects
            • Changelog
          • C++ Application Code
            • Changelog
          • linux_kernel
            • Changelog
          • uSD Image Builder
            • Changelog
        • Changelog
    • Utilities
      • Unreal Engine SDK
        • Release Notes
        • Licensing
        • NDI Plugin Installation
        • Simple Setup of Broadcast and Receivers
        • NDI Broadcast Actor
        • NDI Receiver Actor
        • NDI Media Assets
        • Getting Started with Example Blueprint Projects
        • Advanced
      • Free Audio
      • Bridge Service
        • Installation
          • Silent Installation
        • Configuration
          • Web UI
          • Configuration File
          • Manual API Key Management
        • Webhooks
        • WebSockets
        • API
    • NDI Certified
      • Certification Guidelines
        • Interoperability Requirements
        • Technical Requirements
      • Certification Process
        • Pre-certification Checklist
        • Device Testing Methods
          • Camera
          • HDMI Encoder
          • SDI Encoder
          • Decoder
          • NDI Controller
          • NDI Monitor
          • Multicast Testing
        • Detailed process
    • Metadata
      • Metadata Sources
      • Metadata for XML
      • XML Validation
      • Metadata Elements
      • Proposed New Metadata Messages
      • PTZ and Control Messages
      • Undocumented Mysteries
  • Developer Guides
    • Decoding with NDI
    • NDI Bridge Deployment
  • FAQ
    • Index
    • NDI Tools
      • What is the NDI Analysis Tool and where do I get it from?
      • Why does my NDI connection stay active once the source is offline?
      • Why are my changes to the NDI JSON configuration file not being saved?
      • Why is the license for my Panasonic camera not active?
      • How does registration for NDI Tools work?
      • How do I use NDI output with Microsoft Teams
      • The time code on my file is incorrect, how do I change it?
      • Where is Screen Capture (HX) for Mac?
      • How can I make NDI Tools launch automatically?
      • What is the NDI ECCN?
    • NDI Certified
      • What is the NDI Certification Program?
      • Why did you start this certification program?​
      • What happens to my device after it's certified?
      • Is certification mandatory to be a partner of NDI?​
      • I am an OEM manufacturer, can my products be certified?​
      • How long does the certification process take?
      • How do I become certified?​
      • What happens if my product doesn’t meet the requirements for Certification?​
      • Are there any fees to become NDI Certified?
    • Common Issues
      • I'm having trouble getting multicast set up.
      • I'm having trouble with my NDI HX License
      • Why can't I find my Android 14-based NDI devices on my network?
      • Why won’t NDI Tools install on my Windows PC?
      • How do I enable NDI in “New” Microsoft Teams (Windows only)?
      • Why can’t HX Capture display the full resolution of my iPad or iPhone?
      • The NDI HX Camera app won't launch on older phones and iOS
      • Why won't MacOS Sonoma (14.1) recognize NDI Tools as a virtual camera?
      • I'm having issues with Virtual Input for macOS
      • I'm having issues with Final Cut Pro
      • NDI Camera App Issue
    • SDK
      • Where can I find the source code for the FPGA board?
      • What system resources are required to support a design including the NDI FPGA Codecs?
      • Why can’t my h264/265 video be received by an NDI receiver when using the embedded SDK?
      • Can I use the Unreal SDK on Mac?
      • What are the Differences Between the NDI SDK and the NDI Advanced SDK
    • ✨NDI 6
      • Do I need to upgrade to NDI 6 if I'm not using the new features?
      • Is there a fee to upgrade to NDI 6
      • Why doesn't my existing Vendor ID work with NDI 6?
      • How can I get a previous version of NDI Tools or the SDK?
    • NDI HX License Upgrades
      • What is happening with NDI HX Upgrades?
      • Will my existing HX-upgraded camera be affected?
      • I bought a camera before June 30, 2025, but didn't buy an HX license. Can I still get one?
      • I bought a license and a camera but didn't redeem it until after. Can I still get an HX license?
      • If my HX upgrade fails can I transfer the license?
      • Can I sell my upgraded HX camera and keep the license?
      • Will my NDI version work with my current HX license?
      • What does the HX upgrade sunset program mean for camera manufacturers?
      • What will NDI Support do for licenses after the sunset date?
      • I factory reset my camera and forgot the license. Can you help me get it back?
Powered by GitBook

2024 @ NDI Vizrt AB.

On this page
  • API Calls Using SSL
  • Auto Start
  • GPU List
  • Host Bandwidth
  • Host Bridge Name
  • Host Buffer
  • Host Clear Encryption Key
  • Host GPU Limit
  • Host Groups
  • Host HX Encoder
  • Host HX GPU
  • Host HX NDI4 Compatibility Mode
  • Host HX Output
  • Host HX Quality
  • Host Port
  • Host Set Encryption Key
  • Host Start
  • Host Status
  • Host Stop
  • Is Running
  • Join Bandwidth
  • Join Bridge Name
  • Join Buffer
  • Join Clear Encryption Key
  • Join GPU Limit
  • Join Groups
  • Join HX Encoder
  • Join HX GPU
  • Join HX NDI4 Compatibility Mode
  • Join HX Output
  • Join HX Quality
  • Join IP Address
  • Join Port
  • Join Set Encryption Key
  • Join Start
  • Join Status
  • Join Stop
  • Local Bridge Name
  • Local Groups
  • Local HX GPU
  • Local HX NDI4 Compatibility Mode
  • Local HX Output
  • Local HX Quality
  • Local Send Groups
  • Local Start
  • Local Status
  • Local Stop
  • Connection Test Start
  • Connection Test Start
  • Connection Test Stop
  • Connection Test Bitrate
  • Run Mode
  • Uptime

Was this helpful?

Export as PDF
  1. Developing with NDI
  2. Utilities
  3. Bridge Service

API

Last updated 2 months ago

Was this helpful?

All API calls use GET and or POST requests to retrieve and set values. Every response from a GET or POST request use the same structure. The response is in JSON format and includes a true / false field to indicate success, an error field to provide more detailed information if there is an error, and a content field that contains either the current value of the setting or a message detailing what action the request performed.

{"success":true,"error":null,"content":0}

In addition to this document, the web interface provides a full list of API calls and their use cases.

API Calls Using SSL

When SSL is enabled you must include a valid API key in the header of your request. It key in the header should be named x-api-key and the value should be the API key you issued starting with NDI-. Here is some example C# code for sending GET and POST requests with SSL where API KEY is a string value containing the NDI- prefixed key:

static async Task<string> PostAsync(string uri, Dictionary<string, string> values)
{
var client = new HttpClient(); client.DefaultRequestHeaders.Add("x-api-key", API_KEY);
var content = JsonContent.Create(values);
var result = await client.PostAsync(uri, content); return await result.Content.ReadAsStringAsync();
}
static async Task<string> GetAsync(string uri)
{
var client = new HttpClient(); client.DefaultRequestHeaders.Add("x-api-key", API_KEY);
var result = await client.GetAsync(uri);
return await result.Content.ReadAsStringAsync();
}

The following subsections detail each API endpoint available in NDI Bridge Service:

Auto Start

Get or set whether to start join or host on service start-up. Will always return the latest auto start value. The service must be restarted to reflect this change.

Key
Type
Description
Notes

value

String

(required) 0, 1 or 2 where 0 = None, 1

= Host, and 2 = Join

If provided on a

POST request, the Bridge Service auto start mode will be

set.

GET URL: http://localhost:8080/api/auto_start

POST URL: http://localhost:8080/api/auto_start

EXAMPLE POST CONTENT: {"value":"0"}

GPU List

Gets the list of available GPUs.

GET URL: http://localhost:8080/api/gpu_list

Host Bandwidth

Get the current host bandwidth message.

GET URL: http://localhost:8080/api/host/bandwidth_message

Host Bridge Name

Get or set the host bridge name. Will always return the latest host bridge name.

Key
Type
Description
Notes

value

String

(required) Any string value.

If provided on a

POST request, the host bridge name

will be set.

GET URL: http://localhost:8080/api/host/bridge_name

POST URL: http://localhost:8080/api/host/bridge_name

EXAMPLE POST CONTENT: {"value":"My Bridge Host"}

Host Buffer

Get or set the host buffer value. Will always return the latest host buffer value.

Key
Type

value

String

(optional) A buffer length value from 0-

3000.

Buffer length value

in the range of 0-3000. If pro- vided on a POST request, the host buffer length value

will be set.

GET URL: http://localhost:8080/api/host/buffer

POST URL: http://localhost:8080/api/host/buffer

EXAMPLE POST CONTENT: {"value":"0"}

Host Clear Encryption Key

Clears the host encryption key on POST.

POST URL: http://localhost:8080/api/host/clear_encryption_key

EXAMPLE POST CONTENT: {}

Host GPU Limit

Gets a boolean to represent if the host has reached its GPU encoding limits or not.

GET URL: http://localhost:8080/api/host/gpu_limit

Host Groups

Get or set the host groups to share. Will always return the latest host groups.

Key
Type
Description
Notes

value

String

(required) A comma delineated list of

group names.

If provided on a

POST request, the host groups will be

set.

GET URL: http://localhost:8080/api/host/groups

POST URL: http://localhost:8080/api/host/groups

EXAMPLE POST CONTENT: {"value":"public,test group"}

Host HX Encoder

Get or set the host HX encoder. Will always return the latest host HX encoder value.

Key
Type
Description
Notes

value

String

(required) 0 or 1 where 0 = h.264, 1 =

HEVC (h.265)

If provided on a

POST request, the host HX encoder

type will be set.

GET URL: http://localhost:8080/api/host/hx_encoder

POST URL: http://localhost:8080/api/host/hx_encoder

EXAMPLE POST CONTENT: {"value":"0"}

Host HX GPU

Get or set the host HX GPU. Will always return the latest host HX GPU.

Key
Type
Description
Notes

value

String

(required) The name of the GPU. Use

’Auto’ to automatically select a GPU.

If provided on a

POST request, the host HX GPU will

be set.

GET URL: http://localhost:8080/api/host/hx_gpu

POST URL: http://localhost:8080/api/host/hx_gpu

EXAMPLE POST CONTENT: {"value":"Auto"}

Host HX NDI4 Compatibility Mode

Get or set the host HX NDI4 compatibility mode. Will always return the latest host HX NDI4 compatibility mode value.

Key
Type
Description
Notes

value

String

(required) A boolean to enable or dis-

able NDI4 compatibility mode.

If provided on a

POST request, the host HX NDI4 com- patibility mode will

be set.

GET URL: http://localhost:8080/api/host/hx_ndi4_compatibility_mode

POST URL: http://localhost:8080/api/host/hx_ndi4_compatibility_mode

EXAMPLE POST CONTENT: {"value":"false"}

Host HX Output

Get or set the host HX output. Will always return the latest host HX output value.

Key
Type
Description
Notes

value

String

(required) 0, 1, or 2 where 0 = NDI —

HX, 1 = NDI High Bandwidth, and 2

= Do Not Transcode

If provided on a

POST request, the host HX output

type will be set.

GET URL: http://localhost:8080/api/host/hx_output

POST URL: http://localhost:8080/api/host/hx_output

EXAMPLE POST CONTENT: {"value":"0"}

Host HX Quality

Get or set the host HX quality setting. Will always return the latest host HX quality setting value.

Key
Type
Description
Notes

value

String

(required) A value between 10 and 400

with 10 being the lowest quality.

If provided on a

POST request, the host HX quality

setting will be set.

GET URL: http://localhost:8080/api/host/hx_quality

POST URL: http://localhost:8080/api/host/hx_quality

EXAMPLE POST CONTENT: {"value":"100"}

Host Port

Get or set the host port value. Will always return the latest host port value.

Key
Type
Description
Notes

value

String

(required) Port number in the range of

1-65545.

Port number in the

range of 1-65545. If provided on a POST request, the host port value will

be set.

GET URL: http://localhost:8080/api/host/port

POST URL: http://localhost:8080/api/host/port

EXAMPLE POST CONTENT: {"value":"5990"}

Host Set Encryption Key

Sets the host’s encryption key on POST.

Key
Type
Description
Notes

value

String

(required) The encryption key string

value.

Returns success on

setting the encryp- tion key. Does not return the cur- rent encryption key

value.

POST URL: http://localhost:8080/api/host/set_encryption_key

EXAMPLE POST CONTENT: {"value":"some encryption key"}

Host Start

Starts the host and returns if the operation succeeded or not.

POST URL: http://localhost:8080/api/host/start

EXAMPLE POST CONTENT: {}

Host Status

Gets the current host status message.

GET URL: http://localhost:8080/api/host/status_message

Host Stop

Stops the host if the host was running. Returns if the operation succeeded or not.

POST URL: http://localhost:8080/api/host/stop

EXAMPLE POST CONTENT: {}

Is Running

Returns true if Bridge is running in Host or Join mode.

GET URL: http://localhost:8080/api/is_running

Join Bandwidth

Get the current join bandwidth message.

GET URL: http://localhost:8080/api/join/bandwidth_message

Join Bridge Name

Get or set the join bridge name. Will always return the latest join bridge name.

Key
Type
Description
Notes

value

String

(required) Any string value.

If provided on a

POST request, the join bridge name

will be set.

GET URL: http://localhost:8080/api/join/bridge_name

POST URL: http://localhost:8080/api/join/bridge_name

EXAMPLE POST CONTENT: {"value":"My Bridge Name"}

Join Buffer

Get or set the join buffer value. Will always return the latest join buffer value.

Key
Type
Description
Notes

value

String

(required) A buffer length value from

0-3000.

Buffer length value

in the range of 0-3000. If pro- vided on a POST request, the join buffer length value

will be set.

GET URL: http://localhost:8080/api/join/buffer

POST URL: http://localhost:8080/api/join/buffer

EXAMPLE POST CONTENT: {"value":"100"}

Join Clear Encryption Key

Clears the join encryption key when called.

POST URL: http://localhost:8080/api/join/clear_encryption_key E

XAMPLE POST CONTENT: {}

Join GPU Limit

Gets a boolean to represent if the join has reached its GPU encoding limits or not.

GET URL: http://localhost:8080/api/join/gpu_limit

Join Groups

Get or set the join groups to share. Will always return the latest join groups.

Key
Type
Description
Notes

value

String

(required) A comma delineated list of

group names.

If provided on a

POST request, the join groups will be

set.

GET URL: http://localhost:8080/api/join/groups

POST URL: http://localhost:8080/api/join/groups

EXAMPLE POST CONTENT: {"value":"pubic,test"}

Join HX Encoder

Get or set the join HX encoder. Will always return the latest join HX encoder value.

Key
Type
Description
Notes

value

String

(required) 0 or 1 where 0 = h.264, 1 =

HEVC (h.265)

If provided on a

POST request, the join HX encoder

type will be set.

GET URL: http://localhost:8080/api/join/hx_encoder

POST URL: http://localhost:8080/api/join/hx_encoder

EXAMPLE POST CONTENT: {"value":"0"}

Join HX GPU

Get or set the join HX GPU. Will always return the latest join HX GPU.

Key
Type
Description
Notes

value

String

(required) The name of the GPU. Use

’Auto’ to automatically select a GPU.

If provided on a

POST request, the join HX GPU will

be set.

GET URL: http://localhost:8080/api/join/hx_gpu

POST URL: http://localhost:8080/api/join/hx_gpu

EXAMPLE POST CONTENT: {"value":"Auto"}

Join HX NDI4 Compatibility Mode

Get or set the join HX NDI4 compatibility mode. Will always return the latest join HX NDI4 compatibility mode value.

Key
Type
Description
Notes

value

String

(required) A boolean to enable or dis-

able NDI4 compatibility mode.

If provided on a

POST request, the join HX NDI4 com- patibility mode will

be set.

GET URL: http://localhost:8080/api/join/hx_ndi4_compatibility_mode

POST URL: http://localhost:8080/api/join/hx_ndi4_compatibility_mode

EXAMPLE POST CONTENT: {"value":"false"}

Join HX Output

Get or set the join HX output. Will always return the latest join HX output value.

Key
Type
Description
Notes

value

String

(required) 0, 1, or 2 where 0 = NDI —

HX, 1 = NDI High Bandwidth, and 2

= Do Not Transcode

If provided on a

POST request, the join HX output

type will be set.

GET URL: http://localhost:8080/api/join/hx_output

POST URL: http://localhost:8080/api/join/hx_output

EXAMPLE POST CONTENT: {"value":"0"}

Join HX Quality

Get or set the join HX quality setting. Will always return the latest join HX quality setting value.

Key
Type
Description
Notes

value

String

(required) A value between 10 and 400

with 10 being the lowest quality.

If provided on a

POST request, the join HX quality set-

ting will be set.

GET URL: http://localhost:8080/api/join/hx_quality

POST URL: http://localhost:8080/api/join/hx_quality

EXAMPLE POST CONTENT: {"value":"100"}

Join IP Address

Get or set the join IP address. Will always return the latest join IP address.

Key
Type
Description
Notes

value

String

(required) IP Address in IPv4 format

’127.0.0.1’

If provided on a

POST request, the join IP address will

be set.

GET URL: http://localhost:8080/api/join/ip_address

POST URL: http://localhost:8080/api/join/ip_address

EXAMPLE POST CONTENT: {"value":"127.0.0.1"}

Join Port

Get or set the join port value. Will always return the latest join port value.

Key
Type
Description
Notes

value

String

(required) Port number in the range of

1-65535.

Port number in the

range of 1-65535. If provided on a POST request, the join port value will

be set.

GET URL: http://localhost:8080/api/join/port

POST URL: http://localhost:8080/api/join/port

EXAMPLE POST CONTENT: {"value":"5990"}

Join Set Encryption Key

Sets the join encryption key on POST.

Key
Type
Description
Notes

value

String

(required) The encryption key string

value.

Returns success on

setting the encryp- tion key. Does not return the cur- rent encryption key

value.

POST URL: http://localhost:8080/api/join/set_encryption_key

EXAMPLE POST CONTENT: {"value":"some encryption key"}

Join Start

Starts the join and returns if the operation succeeded or not.

POST URL: http://localhost:8080/api/join/start

EXAMPLE POST CONTENT: {}

Join Status

Gets the current join status message.

GET URL: http://localhost:8080/api/join/status_message

Join Stop

Stops the join if the join was running. Returns if the operation succeeded or not.

POST URL: http://localhost:8080/api/join/stop

EXAMPLE POST CONTENT: {}

Local Bridge Name

Get or set the local bridge name. Will always return the latest local bridge name.

Key
Type
Description
Notes

value

String

(required) Any string value.

If provided on a

POST request, the local bridge name will be set.

GET URL: http://localhost:8080/api/local/bridge_name

POST URL: http://localhost:8080/api/local/bridge_name

EXAMPLE POST CONTENT:{"value":"My Bridge Name"}

Local Groups

Get or set the local groups to share. Will always return the latest local groups.

Key
Type
Description
Notes

value

String

(required) A comma delineated list of

group names.

If provided on a

POST request, the local groups will be set.

GET URL: http://localhost:8080/api/local/groups

POST URL: http://localhost:8080/api/local/groups

EXAMPLE POST CONTENT: {"value":"public,test"}

Local HX GPU

Get or set the local HX GPU. Will always return the latest local HX GPU.

Key
Type
Description
Notes

value

String

(required) The name of the GPU. Use

’Auto’ to automatically select a GPU.

If provided on a

POST request, the local HX GPU will be set.

GET URL: http://localhost:8080/api/local/hx_gpu

POST URL: http://localhost:8080/api/local/hx_gpu

EXAMPLE POST CONTENT: {"value":"Auto"}

Local HX NDI4 Compatibility Mode

Get or set the local HX NDI4 compatibility mode. Will always return the latest local HX NDI4 compatibility mode value.

Key
Type
Description
Notes

value

String

(required) A boolean to enable or dis-

able NDI4 compatibility mode.

If provided on a

POST request, the local HX NDI4 compatibility mode will be set.

GET URL: http://localhost:8080/api/local/hx_ndi4_compatibility_mode

POST URL: http://localhost:8080/api/local/hx_ndi4_compatibility_mode

EXAMPLE POST CONTENT: {"value":"false"}

Local HX Output

Get or set the local HX output. Will always return the latest local HX output value.

Key
Type
Description
Notes

value

String

(required) 0, 1, or 2 where 0 = NDI —

HX, 1 = NDI High Bandwidth, and 2

= Do Not Transcode

If provided on a

POST request, the local HX output type will be set.

GET URL: http://localhost:8080/api/local/hx_output

POST URL: http://localhost:8080/api/local/hx_output

EXAMPLE POST CONTENT: {"value":"0"}

Local HX Quality

Get or set the local HX quality setting. Will always return the latest local HX quality setting value.

Key
Type
Description
Notes

value

String

(required) A value between 10 and 400

with 10 being the lowest quality.

If provided on a

POST request, the local HX quality setting will be set.

GET URL: http://localhost:8080/api/local/hx_quality

POST URL: http://localhost:8080/api/local/hx_quality

EXAMPLE POST CONTENT: {"value":"100"}

Local Send Groups

Get or set the send NDI Groups where locally the sources from this Bridge will appear in. Will always return the current local send groups.

Key

Type

Description

Notes

value

String

(required) A comma delineated list of

send groups names.

If provided on a

POST request, the local send groups will be set.

GET URL: http://localhost:8080/api/local/send_groups

POST URL: http://localhost:8080/api/local/send_groups

EXAMPLE POST CONTENT: {"value":"public,test group"}

Local Start

Starts the local bridge and returns if the operation succeeded or not.

POST URL: http://localhost:8080/api/local/start

EXAMPLE POST CONTENT: {"value":"Local started."}

Local Status

Gets the current local status message.

GET URL: http://localhost:8080/api/local/status_message

Local Stop

Stops the local if the local was running. Returns if the operation succeeded or not.

POST URL: http://localhost:8080/api/local/stop

EXAMPLE POST CONTENT: {"value":"Local stopped."}

Connection Test Start

Starts the connection test. You can use the connection test to help identify the best buffer setting for your chosen bitrate given your current network conditions. You must have at least one active connection to perform a connection test.

POST URL: http://localhost:8080/api/connection_test_start

Connection Test Start

Starts the connection test. You can use the connection test to help identify the best buffer setting for your chosen bitrate given your current network conditions. You must have at least one active connection to perform a connection test.

POST URL: http://localhost:8080/api/connection_test_start

Connection Test Stop

Stops the connection test. The response to this request will include the recommended buffer setting.

POST URL: http://localhost:8080/api/connection_test_stop

Connection Test Bitrate

Get or set the bitrate used in the connection test. Will always return the current bitrate value.

Key
Type
Description
Notes

value

String

(required) Value between 1 and the

maximum speed reported by the net- work adapters. When provided on a POST request, the Bridge Service con-

nection test bitrate will be set.

GET URL: http://localhost:8080/api/connection_test_bitrate

POST URL: http://localhost:8080/api/connection_test_bitrate

Run Mode

Gets the current running mode.

GET URL: http://localhost:8080/api/runmode

Uptime

Returns the timespan since the service started.

GET URL: http://localhost:8080/api/uptime

API GET URL
API POST URL and Instructions
API Properties Figure
API JSON Response