MAC Address Lookup API

Introduction

Welcome to the MAC Vendors API! Our goal is to make our data accessible to anyone that wants to use it, so we made the API as easy to use as possible. Send an HTTP GET with a MAC address and we send back the vendor. There are two ways to call it.

Without a key

Just send the address. You get the vendor's name back as plain text. It suits scripts, one-off checks and anything that only looks up a few addresses.

With an API key

Sign up, get a key, and call the /v1 endpoint. You get the full registration as JSON or plain text, your own limits with a usage dashboard, and paid plans up to a million requests a day.

Making a request

Both endpoints take one MAC address in the path. Any of the usual formats work, and only the prefix matters, so the first six characters are enough for most vendors.


            00-11-22-33-44-55


            00:11:22:33:44:55


            00.11.22.33.44.55

001122334455


            0011.2233.4455


            00:11:22

Without a key

GET


    https://api.macvendors.com/{mac_address}

Request Response: text/plain

$ curl https://api.macvendors.com/FC:FB:FB:01:FA:21
Cisco Systems, Inc

With an API key

GET


    https://api.macvendors.com/v1/lookup/{mac_address}

Send your key in an Authorization: Bearer header. Keys are created on your account page after you sign up. Responses are JSON unless you ask for text/plain in the Accept header, in which case you get just the name.

Request Response: application/json

$ curl https://api.macvendors.com/v1/lookup/FC:FB:FB:01:FA:21 \
       -H "Authorization: Bearer YOUR_API_KEY"
{
  "data": {
    "assignment": "FCFBFB",
    "organization_name": "Cisco Systems, Inc",
    "organization_address": "80 West Tasman Drive San Jose CA US 94568",
    "registry": "MA-L"
  }
}

Responses

200 Found. The vendor's name as plain text, or the JSON above with a key.
404 Not found. No vendor has registered that prefix. The body is a JSON error that says why, such as Not Found or Locally Administered Address. This counts as a request.
429 Slow down. Over the per-second or daily limit. Comes with a Retry-After header. A per-second 429 does not count against your daily quota.
401 Bad key. Keyed endpoint only: the key is missing, wrong or revoked. Not counted.

Code examples

The anonymous endpoint in each language. Keyed examples are in your account's docs once you sign up.

mac_address="FC:FB:FB:01:FA:21"

response=$(curl -s -w "\n%{http_code}" "https://api.macvendors.com/$mac_address")
status=${response##*$'\n'}
body=${response%$'\n'*}

case "$status" in
  200) echo "Vendor: $body" ;;
  404) echo "Not Found" ;;
  # 429: rate limited (1 request/second, 1,000/day without an API key)
  *)   echo "Request failed with status $status" ;;
esac

const macAddress = "FC:FB:FB:01:FA:21";

const response = await fetch(
  `https://api.macvendors.com/${encodeURIComponent(macAddress)}`
);

if (response.ok) {
  console.log(`Vendor: ${await response.text()}`);
} else if (response.status === 404) {
  console.log("Not Found");
} else {
  // 429: rate limited (1 request/second, 1,000/day without an API key)
  console.error(`Request failed with status ${response.status}`);
}

import requests

mac_address = "FC:FB:FB:01:FA:21"

response = requests.get(f"https://api.macvendors.com/{mac_address}")

if response.ok:
    print(f"Vendor: {response.text}")
elif response.status_code == 404:
    print("Not Found")
else:
    # 429: rate limited (1 request/second, 1,000/day without an API key)
    print(f"Request failed with status {response.status_code}")

require "net/http"

mac_address = "FC:FB:FB:01:FA:21"
uri = URI("https://api.macvendors.com/#{mac_address}")

res = Net::HTTP.get_response(uri)

case res
when Net::HTTPSuccess then puts "Vendor: #{res.body}"
when Net::HTTPNotFound then puts "Not Found"
else
  # 429: rate limited (1 request/second, 1,000/day without an API key)
  puts "Request failed with status #{res.code}"
end

<?php

$mac_address = "FC:FB:FB:01:FA:21";

$ch = curl_init("https://api.macvendors.com/" . rawurlencode($mac_address));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

if ($status === 200) {
    echo "Vendor: " . $body;
} elseif ($status === 404) {
    echo "Not Found";
} else {
    // 429: rate limited (1 request/second, 1,000/day without an API key)
    echo "Request failed with status " . $status;
}

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	macAddress := "FC:FB:FB:01:FA:21"

	res, err := http.Get("https://api.macvendors.com/" + url.PathEscape(macAddress))
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	switch res.StatusCode {
	case http.StatusOK:
		body, _ := io.ReadAll(res.Body)
		fmt.Printf("Vendor: %s\n", body)
	case http.StatusNotFound:
		fmt.Println("Not Found")
	default:
		// 429: rate limited (1 request/second, 1,000/day without an API key)
		fmt.Printf("Request failed with status %d\n", res.StatusCode)
	}
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class MacLookup {
    public static void main(String[] args) throws Exception {
        String macAddress = "FC:FB:FB:01:FA:21";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.macvendors.com/" + macAddress))
            .build();

        HttpResponse<String> response =
            HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

        switch (response.statusCode()) {
            case 200 -> System.out.println("Vendor: " + response.body());
            case 404 -> System.out.println("Not Found");
            // 429: rate limited (1 request/second, 1,000/day without an API key)
            default -> System.out.println("Request failed with status " + response.statusCode());
        }
    }
}

using System.Net;

var macAddress = "FC:FB:FB:01:FA:21";

using var client = new HttpClient();
var response = await client.GetAsync(
    $"https://api.macvendors.com/{Uri.EscapeDataString(macAddress)}");

switch (response.StatusCode)
{
    case HttpStatusCode.OK:
        Console.WriteLine($"Vendor: {await response.Content.ReadAsStringAsync()}");
        break;
    case HttpStatusCode.NotFound:
        Console.WriteLine("Not Found");
        break;
    default:
        // 429: rate limited (1 request/second, 1,000/day without an API key)
        Console.WriteLine($"Request failed with status {(int)response.StatusCode}");
        break;
}

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking"] }

use reqwest::{blocking::get, StatusCode};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mac_address = "FC:FB:FB:01:FA:21";

    let response = get(format!("https://api.macvendors.com/{mac_address}"))?;

    match response.status() {
        StatusCode::OK => println!("Vendor: {}", response.text()?),
        StatusCode::NOT_FOUND => println!("Not Found"),
        // 429: rate limited (1 request/second, 1,000/day without an API key)
        status => println!("Request failed with status {status}"),
    }

    Ok(())
}

import Foundation

let macAddress = "FC:FB:FB:01:FA:21"
let url = URL(string: "https://api.macvendors.com/\(macAddress)")!

let (data, response) = try await URLSession.shared.data(from: url)
let status = (response as! HTTPURLResponse).statusCode

switch status {
case 200:
    print("Vendor: \(String(decoding: data, as: UTF8.self))")
case 404:
    print("Not Found")
default:
    // 429: rate limited (1 request/second, 1,000/day without an API key)
    print("Request failed with status \(status)")
}

Unregistered	1/sec	1,000/day
Free	2/sec	1,000/day
10K	10/sec	10,000/day
50K	25/sec	50,000/day
100K	25/sec	100,000/day
1M	100/sec	1,000,000/day

//Introduction

//Making a request

Without a key

With an API key

//Responses

//Code examples

Introduction

Making a request

Responses

Code examples