Who it is for
Use the suite for troubleshooting, migration checks, infrastructure research, and security review.
DNS & Infrastructure · DomScan product
MAC Address Lookup API
Look up manufacturer information for a MAC address.
What you get
Look up manufacturer information for a MAC address.
SynchronousRESTMCPSDKInteractive tool
Choose this product when
Choose this product when
Choose this to map a MAC address prefix to published vendor-allocation evidence, not to identify a device owner.
What you get
Look up manufacturer information for a MAC address.
Endpoints
Review the supported operations, inputs, outputs, execution modes, and response limits before integrating.
Credits and authentication
0-1 Authentication required. Check the operation reference for the exact cost and any per-item pricing.
Example operation
Use documented operations to collect, assess, enrich, verify, compare, protect, or monitor public evidence.
GET
/v1/mac
Credits: 1
Query parameters
| Parameter | Type | required |
|---|---|---|
| mac | string | required |
Response fields
| Field | Type |
|---|---|
mac |
string |
input |
string |
type |
string |
oui |
string |
device_id |
string |
flags |
object |
flags.multicast |
boolean |
flags.locally_administered |
boolean |
flags.broadcast |
boolean |
vendor |
object |
vendor.name |
string | null |
vendor.found |
boolean |
vendor.organization |
string | null |
vendor.address |
string | null |
vendor.country |
string | null |
vendor.device_type |
string | null |
vendor.source |
string |
vendor.cached |
boolean |
vendor.cache_age_s |
integer | null |
vendor.checked_at |
string |
meta |
object |
Example request
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/mac?mac=00%3A1A%3A2B%3A3C%3A4D%3A5E"const response = await fetch("https://domscan.net/v1/mac?mac=00%3A1A%3A2B%3A3C%3A4D%3A5E", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/mac?mac=00%3A1A%3A2B%3A3C%3A4D%3A5E",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/mac?mac=00%3A1A%3A2B%3A3C%3A4D%3A5E", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/mac?mac=00%3A1A%3A2B%3A3C%3A4D%3A5E")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))Example response
{
"mac": "00:1A:2B:3C:4D:5E",
"input": "00:1A:2B:3C:4D:5E",
"type": "eui-48",
"oui": "00:1A:2B",
"device_id": "3C:4D:5E",
"flags": {
"multicast": false,
"locally_administered": false,
"broadcast": false
},
"vendor": {
"name": "Ayecom Technology Co., Ltd.",
"found": true,
"source": "live",
"cached": false,
"checked_at": "2026-10-09T10:15:30.000Z"
},
"meta": {
"served_by": "pop=MAD country=ES",
"latency_ms": 184
}
}HTTP status codes
200OK400Bad Request401Unauthorized402Payment Required429Too Many Requests503Service Unavailable
Frequently asked questions
Where can I find the MAC Address Lookup request and response reference?
Use the API reference for MAC Address Lookup to review parameters, response fields, examples, status codes, and supported operation modes.
How should I interpret unknown or incomplete results from MAC Address Lookup?
Unknown or partial results mean that the requested evidence could not be fully determined. Keep the result state, confidence, freshness, and limitations in downstream decisions.
How is MAC Address Lookup priced?
Pricing depends on the operation and execution mode. Check the endpoint reference for the current credit cost, authentication requirement, and per-item rules.
