OUIs

Organization Unique Identifiers

OUIs are used to assign part of the global address space to a given set of router addresses. Hotspots that see device traffic will look up the router address for the given device OUI and offer the device data to registered router.

---

List OUIs

GET https://api.helium.io/v1/ouis

Lists all OUI transactions known to the blockchain.

This route is cursor paginated.

Request

Query Parameters

param	Type	Note
cursor (optional)	string	Cursor for page of results to fetch

Response

200: OK

{
  "data": [
    {
      "subnets": [
        {
          "mask": 8388606,
          "base": 2080
        }
      ],
      "owner": "13o9kcgQQTLPGZMej8ya3RjRBWytJnGZkiLyruu4J9dqXgEDyvZ",
      "oui": 7,
      "nonce": 0,
      "block": 762430,
      "addresses": []
    },
    {
      "subnets": [
        {
          "mask": 8388606,
          "base": 2072
        }
      ],
      "owner": "13HWrdkMoooYJEYz8LjKWzfK1oZifCzwxPaCnV9XDJbC5Gso1ic",
      "oui": 6,
      "nonce": 1,
      "block": 762430,
      "addresses": []
    },
    {
      "subnets": [
        {
          "mask": 8388606,
          "base": 2064
        }
      ],
      "owner": "11P9o2DQNqkQ5GU6RTGcdUbRRtjc3syyhN29nFvm4ZfuhMnHj4S",
      "oui": 5,
      "nonce": 1,
      "block": 762430,
      "addresses": []
    },
    {
      "subnets": [
        {
          "mask": 8388606,
          "base": 2056
        }
      ],
      "owner": "11xHXS5AgLyjYRCJ4ctcWcsMRULS8jro9Pb1GPaTG1neGk1dNcf",
      "oui": 4,
      "nonce": 1,
      "block": 762430,
      "addresses": []
    },
    {
      "subnets": [
        {
          "mask": 8388606,
          "base": 2048
        }
      ],
      "owner": "14oSuAgRmAFPFPZRY1MUwir5AJSLGkaXHzuSZJ92BuYCfLMN1Et",
      "oui": 3,
      "nonce": 3,
      "block": 762430,
      "addresses": []
    },
    {
      "subnets": [
        {
          "mask": 8388352,
          "base": 1024
        }
      ],
      "owner": "1124CJ9yJaHq4D6ugyPCDnSBzQik61C1BqD9VMh1vsUmjwt16HNB",
      "oui": 2,
      "nonce": 8,
      "block": 762430,
      "addresses": []
    },
    {
      "subnets": [
        {
          "mask": 8388352,
          "base": 0
        }
      ],
      "owner": "13tyMLKRFYURNBQqLSqNJg9k41maP1A7Bh8QYxR13oWv7EnFooc",
      "oui": 1,
      "nonce": 0,
      "block": 762430,
      "addresses": ["112qB3YaH5bZkCnKA5uRH7tBtGNv2Y5B4smv1jsmvGUzgKT71QpE"]
    }
  ]
}

---

Get an OUI

GET https://api.helium.io/v1/ouis/:oui

Returns information for a specific OUI.

Request

No Parameters

Response

200: OK

{
  "data": {
    "subnets": [
      {
        "mask": 8388352,
        "base": 1024
      }
    ],
    "owner": "1124CJ9yJaHq4D6ugyPCDnSBzQik61C1BqD9VMh1vsUmjwt16HNB",
    "oui": 2,
    "nonce": 8,
    "block": 762436,
    "addresses": []
  }
}

---

Get last assigned OUI

GET https://api.helium.io/v1/ouis/last

Returns the last assigned OUI transaction. The last assigned OUI can be used to request a new OUI

Request

No Parameters

Response

200: OK

{
  "data": {
    "subnets": [
      {
        "mask": 8388606,
        "base": 2080
      }
    ],
    "owner": "13o9kcgQQTLPGZMej8ya3RjRBWytJnGZkiLyruu4J9dqXgEDyvZ",
    "oui": 7,
    "nonce": 0,
    "block": 762431,
    "addresses": []
  }
}

---

Get OUI Stats

GET https://api.helium.io/v1/ouis/stats

Returns stats for the registered OUIs

Request

No Parameters

Response

200: OK

{
  "data": {
    "count": 7
  }
}