The OpenDNS Network Devices API Developer Hub

Welcome to the OpenDNS Network Devices API developer hub. You'll find comprehensive guides and documentation to help you start working with OpenDNS Network Devices API as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Organization ID endpoint

GET /v1/organizations

The first query is to determine your organization ID, or 'orgId'. An organization ID is a required parameter for all subsequent queries.

An organization ID can also be obtained directly from the Umbrella dashboard after you login to that particular organization, as it will be in the URL of your browser:

https://dashboard.umbrella.com/o/{organizationId}/#/overview

This endpoint has no parameters.

Sample query:

curl -i -X GET --url "https://management.api.umbrella.com/v1/organizations" --header 'Authorization: Basic %base64string%'

Responses

Success

Example return for successfully retrieving organization id and name - HTTP 200

GET https://management.api.umbrella.com/v1/organizations
REQUEST
curl --include \
     --header "Authorization: Basic %base64string%" \
https://management.api.umbrella.com/v1/organizations
    
RESPONSE (HTTP 200, Content-Type: application/json)
[
  {
    "organizationId": 1234567,
    "name": "Your Organization Name"
  }
]
    

Updated about a year ago

Organization ID endpoint


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.