{"info":{"_postman_id":"48eb792c-4670-401a-8f78-018e979e983b","name":"macadress.com MAC Address and OUI Vendor Lookup API","description":"<html><head></head><body><p>Look up the manufacturer behind any MAC address or OUI, straight from IEEE's public registries (MA-L, MA-M, MA-S, IAB, CID), refreshed daily.</p>\n<ul>\n<li>Website: <a href=\"https://macadress.com\">https://macadress.com</a></li>\n<li>API docs: <a href=\"https://macadress.com/docs\">https://macadress.com/docs</a></li>\n<li>Free API key: <a href=\"https://macadress.com/signup\">https://macadress.com/signup</a></li>\n<li>Pricing and limits: <a href=\"https://macadress.com/pricing\">https://macadress.com/pricing</a></li>\n<li>Keyless free endpoint overview: <a href=\"https://macadress.com/free-mac-address-api\">https://macadress.com/free-mac-address-api</a></li>\n<li>OpenAPI 3.1 spec: <a href=\"https://macadress.com/static/openapi.yaml\">https://macadress.com/static/openapi.yaml</a></li>\n<li>MCP server: <a href=\"https://mcp.macadress.com\">https://mcp.macadress.com</a></li>\n<li>Source: <a href=\"https://github.com/samymassoud/macadress\">https://github.com/samymassoud/macadress</a></li>\n</ul>\n<h2 id=\"try-it-with-zero-setup\">Try it with zero setup</h2>\n<p>The <strong>Start here</strong> folder needs no API key. Send <code>GET Vendor name</code> and the whole response body is the vendor, as plain text. Free for 1,000 lookups per UTC day per IP.</p>\n<h2 id=\"everything-else\">Everything else</h2>\n<ol>\n<li>Create a free account at <a href=\"https://macadress.com/signup\">https://macadress.com/signup</a></li>\n<li>Copy your key from <a href=\"https://macadress.com/account\">https://macadress.com/account</a></li>\n<li>Paste it into the <code>apiKey</code> collection variable, or import the <code>macadress.com API</code> environment and set it there.</li>\n</ol>\n<p>The collection sends it as <code>Authorization: Bearer </code> automatically.</p>\n<h2 id=\"rate-limits-and-quota\">Rate limits and quota</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Plan</th>\n<th>Requests / min</th>\n<th>Lookups / 30-day cycle</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>Free</td>\n<td>30</td>\n<td>1,000</td>\n</tr>\n<tr>\n<td>Growth</td>\n<td>120</td>\n<td>100,000</td>\n</tr>\n<tr>\n<td>Scale</td>\n<td>600</td>\n<td>1,000,000</td>\n</tr>\n</tbody>\n</table>\n</div><p>The keyless <code>GET /v1/vendor/:mac</code> endpoint has its own budget: 1,000 per UTC day per IP, plus 60 per minute. Full detail at <a href=\"https://macadress.com/docs\">https://macadress.com/docs</a>.</p>\n<h2 id=\"formats-accepted\">Formats accepted</h2>\n<p><code>AA:BB:CC:DD:EE:FF</code>, <code>AA-BB-CC-DD-EE-FF</code>, <code>aabb.ccdd.eeff</code>, <code>AA BB CC DD EE FF</code>, or <code>AABBCCDDEEFF</code>. Case does not matter.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"57837480","collectionId":"48eb792c-4670-401a-8f78-018e979e983b","publishedId":"2sBYAuTBhB","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-08-31T08:30:30.000Z"},"item":[{"name":"Start here (no API key)","item":[{"name":"Vendor name (plain text)","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Status is 200, 404, or 400\", function () {","    pm.expect(pm.response.code).to.be.oneOf([200, 404, 400]);","});","","if (pm.response.code === 200) {","    const name = pm.response.text().trim();","    pm.collectionVariables.set(\"lastVendorName\", name);","    pm.test(\"Body is a non-empty vendor name\", function () {","        pm.expect(name.length).to.be.above(0);","    });","}"],"id":"5c35589e-a0f8-4196-b450-f16239b44cf8"}}],"id":"b3aa04c9-1023-4250-903c-ad3f1bce8dda","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.macadress.com/v1/vendor/:mac","description":"<p><code>GET https://api.macadress.com/v1/vendor/:mac</code></p>\n<p>The registered vendor name as <strong>plain text</strong>, and nothing else. No API key, no signup. A one-liner:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>curl https://api.macadress.com/v1/vendor/00:03:93:AB:12:34\n</code></pre><p><strong>Free:</strong> 1,000 lookups per UTC day per IP, plus 60 requests/minute. Send an <code>apiKey</code> and the daily cap becomes your plan's cycle quota instead (the first 1,000/day still do not draw it down).</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Status</th>\n<th>Body</th>\n<th>Meaning</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>200</td>\n<td><code>Apple, Inc.</code></td>\n<td>Registered vendor name</td>\n</tr>\n<tr>\n<td>404</td>\n<td><code>not registered</code></td>\n<td>Prefix not in the current IEEE snapshot, or a private block</td>\n</tr>\n<tr>\n<td>404</td>\n<td><code>locally administered</code></td>\n<td>Locally administered address (usually privacy randomization), no vendor prefix</td>\n</tr>\n<tr>\n<td>400</td>\n<td><code>invalid mac address</code></td>\n<td>Input did not parse</td>\n</tr>\n<tr>\n<td>429</td>\n<td><code>rate limited</code></td>\n<td>Over the daily grant or the per-minute burst</td>\n</tr>\n</tbody>\n</table>\n</div><p>Responses set <code>Access-Control-Allow-Origin: *</code>, so browser code can call this directly, and a cacheable <code>Cache-Control</code>. How it compares to other free MAC vendor APIs: <a href=\"https://macadress.com/free-mac-address-api\">https://macadress.com/free-mac-address-api</a></p>\n","urlObject":{"path":["v1","vendor",":mac"],"host":["https://api.macadress.com"],"query":[],"variable":[{"id":"041f6092-5c81-47d2-8e10-c680cf08e02e","description":{"content":"<p>A MAC address in any common format, or a bare OUI like 00:03:93.</p>\n","type":"text/plain"},"type":"any","value":"00:03:93:AB:12:34","key":"mac"}]}},"response":[{"id":"189099eb-23d3-46a7-b339-92a4ae015133","name":"200 registered vendor","originalRequest":{"method":"GET","header":[],"url":"https://api.macadress.com/v1/vendor/00:03:93:AB:12:34"},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain; charset=utf-8"},{"key":"Cache-Control","value":"public, max-age=86400"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-Data-Version","value":"2026-08-30"}],"cookie":[],"responseTime":null,"body":"Apple, Inc."},{"id":"beee889f-9450-44bb-8baa-952220ea5496","name":"404 not registered","originalRequest":{"method":"GET","header":[],"url":"https://api.macadress.com/v1/vendor/FF:FF:FF:FF:FF:FF"},"status":"Not Found","code":404,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"not registered"},{"id":"486bc4de-40bc-4549-ad91-0e6592c2278a","name":"400 invalid mac address","originalRequest":{"method":"GET","header":[],"url":"https://api.macadress.com/v1/vendor/not-a-mac"},"status":"Bad Request","code":400,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"invalid mac address"}],"_postman_id":"b3aa04c9-1023-4250-903c-ad3f1bce8dda"},{"name":"Health check","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Status is 200\", function () { pm.response.to.have.status(200); });","pm.test(\"status is ok\", function () {","    pm.expect(pm.response.json().status).to.eql(\"ok\");","});"],"id":"7852ebe2-970f-42a9-a924-5596bac30aad"}}],"id":"656ee8f8-3ad5-4083-8454-5163268950f0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.macadress.com/v1/healthz","description":"<p><code>GET https://api.macadress.com/v1/healthz</code></p>\n<p><code>200 {\"status\":\"ok\"}</code> when the database is reachable, <code>503</code> otherwise. No key, not counted against any quota. Meant for uptime checks.</p>\n","urlObject":{"path":["v1","healthz"],"host":["https://api.macadress.com"],"query":[],"variable":[]}},"response":[{"id":"3119e302-2dcb-4ab4-be82-bfbf1cf91b74","name":"200 ok","originalRequest":{"method":"GET","header":[],"url":"https://api.macadress.com/v1/healthz"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"ok\"\n}"}],"_postman_id":"656ee8f8-3ad5-4083-8454-5163268950f0"}],"id":"be288eb5-56ec-4261-811c-369eb693a24f","description":"<p>Endpoints that work right now with nothing configured. Great for a quick demo or browser-side code.</p>\n<p>The star is <code>GET Vendor name</code>: the whole response body is the vendor, as text. When you want the full JSON analysis, create a free key at <a href=\"https://macadress.com/signup\">https://macadress.com/signup</a> and open the next folder.</p>\n","_postman_id":"be288eb5-56ec-4261-811c-369eb693a24f","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"48eb792c-4670-401a-8f78-018e979e983b","id":"48eb792c-4670-401a-8f78-018e979e983b","name":"macadress.com MAC Address and OUI Vendor Lookup API","type":"collection"}}},{"name":"Vendor lookup (API key)","item":[{"name":"Look up one MAC address","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Status is 200\", function () { pm.response.to.have.status(200); });","const body = pm.response.json();","pm.test(\"Echoes a canonical MAC\", function () { pm.expect(body.mac).to.be.a(\"string\"); });","pm.test(\"Has an oui\", function () { pm.expect(body.oui).to.be.a(\"string\"); });","pm.test(\"meta.api_version is v1\", function () { pm.expect(body.meta.api_version).to.eql(\"v1\"); });","if (body.organization) { pm.collectionVariables.set(\"lastOrganization\", body.organization); }"],"id":"258d4b83-771b-4280-8ae2-1bf336609798"}}],"id":"078e4409-0ecb-4cbb-a403-66fb7f977a59","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.macadress.com/v1/mac/:mac","description":"<p><code>GET https://api.macadress.com/v1/mac/:mac</code> (needs <code>apiKey</code>)</p>\n<p>The full analysis of one address: vendor, registry block, address range, transmission and administration type, EUI-64 and IPv6 link-local derivation, randomization and virtualization signals, device-category inference, and a plain-English <code>explanation</code>.</p>\n<p>Every field beyond the original v1 set is additive and nullable. Field-by-field reference: <a href=\"https://macadress.com/docs\">https://macadress.com/docs</a></p>\n<p>Get a free key: <a href=\"https://macadress.com/signup\">https://macadress.com/signup</a></p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"48eb792c-4670-401a-8f78-018e979e983b","id":"48eb792c-4670-401a-8f78-018e979e983b","name":"macadress.com MAC Address and OUI Vendor Lookup API","type":"collection"}},"urlObject":{"path":["v1","mac",":mac"],"host":["https://api.macadress.com"],"query":[],"variable":[{"id":"5fc132c0-8fbe-43ef-8080-73a82e0c5115","description":{"content":"<p>A MAC address in any common format (colon, dash, dot-grouped, spaced, or bare hex), case-insensitive.</p>\n","type":"text/plain"},"type":"any","value":"00:03:93:AB:12:34","key":"mac"}]}},"response":[{"id":"5c17da57-f430-4f44-9b4a-b91c079b7b6e","name":"200 lookup result","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":"https://api.macadress.com/v1/mac/00:03:93:AB:12:34"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Data-Version","value":"2026-08-30"},{"key":"X-Request-Id","value":"5249ebff-787d-4776-97c3-235a8c95823c"}],"cookie":[],"responseTime":null,"body":"{\n  \"mac\": \"00:03:93:AB:12:34\",\n  \"valid\": true,\n  \"oui\": \"00:03:93\",\n  \"organization\": \"Apple, Inc.\",\n  \"vendor_address\": \"1 Infinite Loop Cupertino CA US 95014\",\n  \"country\": \"US\",\n  \"block_type\": \"MA-L\",\n  \"address_capacity\": 16777216,\n  \"range_start\": \"00:03:93:00:00:00\",\n  \"range_end\": \"00:03:93:FF:FF:FF\",\n  \"registered\": true,\n  \"transmission_type\": \"unicast\",\n  \"administration_type\": \"universally_administered\",\n  \"locally_administered\": false,\n  \"slap_quadrant\": null,\n  \"eui64\": \"02:03:93:FF:FE:AB:12:34\",\n  \"ipv6_link_local\": \"fe80::203:93ff:feab:1234\",\n  \"potentially_randomized\": false,\n  \"randomization_confidence\": \"none\",\n  \"vendor_lookup_reliable\": true,\n  \"is_zero\": false,\n  \"is_broadcast\": false,\n  \"explanation\": \"This is a universally administered unicast address with a registered vendor prefix.\",\n  \"is_private\": false,\n  \"matched_prefix\": \"00:03:93\",\n  \"prefix_length\": 24,\n  \"registry\": { \"source\": \"IEEE\", \"record_type\": \"MA-L\", \"record_updated_at\": null, \"database_synced_at\": \"2026-08-30T03:10:00Z\" },\n  \"device\": { \"category\": \"consumer_electronics\", \"possible_categories\": [\"smartphone\", \"tablet\", \"computer\", \"media_device\"], \"confidence\": \"medium\", \"inference_source\": \"vendor_profile\", \"exact_model_known\": false },\n  \"virtualization\": { \"detected\": false, \"platform\": null, \"confidence\": \"none\", \"signals\": [] },\n  \"special_use\": { \"detected\": false, \"type\": null, \"protocol\": null, \"name\": null, \"source\": null, \"confidence\": \"none\" },\n  \"vendor_location\": { \"raw\": \"1 Infinite Loop Cupertino CA US 95014\", \"address_line\": null, \"city\": null, \"region\": null, \"postal_code\": null, \"country_code\": \"US\", \"country_name\": \"United States\", \"parse_confidence\": \"low\" },\n  \"randomization\": { \"potentially_randomized\": false, \"confidence\": \"none\", \"signals\": [], \"alternative_explanations\": [] },\n  \"local_vendor_derivation\": { \"detected\": false, \"method\": \"\", \"universal_mac\": null, \"confidence\": \"none\", \"organization\": null, \"country\": null, \"matched_prefix\": null, \"block_type\": null, \"lookup_url\": null, \"device\": null, \"signals\": [] },\n  \"assignment\": { \"registered_at\": null, \"first_seen_at\": \"2026-08-22\", \"last_changed_at\": \"2026-08-22\" },\n  \"vendor\": { \"id\": \"apple-inc\", \"registered_name\": \"Apple, Inc.\", \"canonical_name\": \"Apple, Inc.\", \"slug\": \"apple-inc\", \"block_count\": 1553, \"lookup_url\": \"https://macadress.com/vendor/000393\" },\n  \"meta\": { \"request_id\": \"5249ebff-787d-4776-97c3-235a8c95823c\", \"api_version\": \"v1\", \"database_version\": \"2026-08-30\", \"processed_at\": \"2026-08-30T10:26:47Z\", \"cached\": true }\n}"},{"id":"e8f24e7d-7cb4-4fc6-bb97-061c80d9abdd","name":"400 invalid input","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":"https://api.macadress.com/v1/mac/not-a-mac"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"valid\": false,\n  \"error\": \"invalid MAC address\",\n  \"request_id\": \"19ee676c-4410-443f-813e-3bbb3433b4bf\"\n}"},{"id":"51f98565-e5a7-44a6-b5ee-4073c76729b6","name":"401 missing API key","originalRequest":{"method":"GET","header":[],"url":"https://api.macadress.com/v1/mac/00:03:93:AB:12:34"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"error\": \"missing API key: pass it as \\\"api_key\\\" (query param or POST body) or an Authorization: Bearer header\"\n}"}],"_postman_id":"078e4409-0ecb-4cbb-a403-66fb7f977a59"},{"name":"Look up many MAC addresses","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Status is 200\", function () { pm.response.to.have.status(200); });","const body = pm.response.json();","pm.test(\"count matches results length\", function () {","    pm.expect(body.count).to.eql(body.results.length);","});","pm.test(\"Each result carries its input\", function () {","    body.results.forEach(function (r) { pm.expect(r).to.have.property(\"input\"); });","});"],"id":"d8eb86b8-7e98-4bb6-989d-6d1d1429569b"}}],"id":"33dab2c3-8bd1-463a-9471-19e0018ab888","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"macs\": [\n    \"00:03:93:AB:12:34\",\n    \"F4:5C:89:AA:BB:CC\",\n    \"not-a-mac\"\n  ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.macadress.com/v1/mac/batch","description":"<p><code>POST https://api.macadress.com/v1/mac/batch</code> (needs <code>apiKey</code>)</p>\n<p>Look up to 100 addresses in one request. A bad entry does not fail the batch: each result carries its own status.</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{ \"macs\": [\"00:03:93:AB:12:34\", \"F4:5C:89:AA:BB:CC\"] }\n</code></pre>\n<p>Each entry has the same shape as <code>GET /v1/mac/:mac</code> plus <code>input</code>, and <code>error</code> on failure. Every entry in one call shares the same <code>meta.request_id</code>. Billed per address actually looked up, not per request. You can also send the key inline as an <code>\"api_key\"</code> field in the body. Docs: <a href=\"https://macadress.com/docs\">https://macadress.com/docs</a></p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"48eb792c-4670-401a-8f78-018e979e983b","id":"48eb792c-4670-401a-8f78-018e979e983b","name":"macadress.com MAC Address and OUI Vendor Lookup API","type":"collection"}},"urlObject":{"path":["v1","mac","batch"],"host":["https://api.macadress.com"],"query":[],"variable":[]}},"response":[{"id":"0aa50b1c-df08-4753-955c-741740969e3b","name":"200 batch results","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n  \"macs\": [\"00:03:93:AB:12:34\", \"not-a-mac\"]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.macadress.com/v1/mac/batch"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"count\": 2,\n  \"results\": [\n    {\n      \"input\": \"00:03:93:AB:12:34\",\n      \"mac\": \"00:03:93:AB:12:34\",\n      \"valid\": true,\n      \"organization\": \"Apple, Inc.\",\n      \"matched_prefix\": \"00:03:93\",\n      \"registered\": true,\n      \"meta\": { \"request_id\": \"d204feb2-6a1e-4c9a-9b0f-3e0b7c2b9a11\", \"api_version\": \"v1\", \"database_version\": \"2026-08-30\", \"processed_at\": \"2026-08-30T10:27:51Z\", \"cached\": true }\n    },\n    {\n      \"input\": \"not-a-mac\",\n      \"error\": \"invalid MAC address\",\n      \"mac\": \"\",\n      \"valid\": false,\n      \"organization\": null,\n      \"matched_prefix\": null,\n      \"meta\": { \"request_id\": \"d204feb2-6a1e-4c9a-9b0f-3e0b7c2b9a11\", \"api_version\": \"v1\", \"database_version\": \"2026-08-30\", \"processed_at\": \"2026-08-30T10:27:51Z\", \"cached\": true }\n    }\n  ]\n}"}],"_postman_id":"33dab2c3-8bd1-463a-9471-19e0018ab888"},{"name":"Extract MACs from text","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Status is 200\", function () { pm.response.to.have.status(200); });","const body = pm.response.json();","pm.test(\"Has a truncated flag\", function () { pm.expect(body).to.have.property(\"truncated\"); });","pm.test(\"count matches results length\", function () {","    pm.expect(body.count).to.eql(body.results.length);","});"],"id":"ed1a0935-a7fb-45c8-b027-d0b6e2232124"}}],"id":"4366d6bb-4e2c-41d0-af49-9df55cd5a634","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"text\": \"? (192.168.1.1) at 00:03:93:ab:12:34 on en0 ifscope [ethernet], ? (192.168.1.5) at f4:5c:89:aa:bb:cc on en0 ifscope [ethernet]\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.macadress.com/v1/mac/extract","description":"<p><code>POST https://api.macadress.com/v1/mac/extract</code> (needs <code>apiKey</code>)</p>\n<p>Scan free-form text (<code>arp -a</code> output, log dumps, DHCP leases) for anything that looks like a MAC address and look up every one found, up to 100.</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{ \"text\": \"? (192.168.1.1) at 00:03:93:ab:12:34 on en0 [ethernet]\" }\n</code></pre>\n<p>Addresses are deduplicated and returned in first-seen order. <code>truncated</code> is <code>true</code> if more than 100 distinct addresses were present. Bills per address looked up, same as batch. Docs: <a href=\"https://macadress.com/docs\">https://macadress.com/docs</a></p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"48eb792c-4670-401a-8f78-018e979e983b","id":"48eb792c-4670-401a-8f78-018e979e983b","name":"macadress.com MAC Address and OUI Vendor Lookup API","type":"collection"}},"urlObject":{"path":["v1","mac","extract"],"host":["https://api.macadress.com"],"query":[],"variable":[]}},"response":[{"id":"5f086ae6-f883-4244-80e0-c147c430aaa3","name":"200 extracted and resolved","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n  \"text\": \"? (192.168.1.1) at 00:03:93:ab:12:34 on en0 ifscope [ethernet]\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.macadress.com/v1/mac/extract"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"count\": 1,\n  \"truncated\": false,\n  \"results\": [\n    {\n      \"input\": \"00:03:93:AB:12:34\",\n      \"mac\": \"00:03:93:AB:12:34\",\n      \"valid\": true,\n      \"organization\": \"Apple, Inc.\",\n      \"matched_prefix\": \"00:03:93\",\n      \"registered\": true,\n      \"meta\": { \"request_id\": \"d204feb2-6a1e-4c9a-9b0f-3e0b7c2b9a11\", \"api_version\": \"v1\", \"database_version\": \"2026-08-30\", \"processed_at\": \"2026-08-30T10:27:51Z\", \"cached\": true }\n    }\n  ]\n}"}],"_postman_id":"4366d6bb-4e2c-41d0-af49-9df55cd5a634"},{"name":"Search the vendor directory","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Status is 200\", function () { pm.response.to.have.status(200); });","const body = pm.response.json();","pm.test(\"total is a number\", function () { pm.expect(body.total).to.be.a(\"number\"); });","pm.test(\"blocks is an array\", function () { pm.expect(body.blocks).to.be.an(\"array\"); });"],"id":"672d0c6c-175c-4a71-8b39-3ec705eb99d7"}}],"id":"5b1d8253-3644-49cb-b5e1-a82b4c45fa04","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.macadress.com/v1/vendors?query=Apple&country=US&limit=10","description":"<p><code>GET https://api.macadress.com/v1/vendors</code> (needs <code>apiKey</code>)</p>\n<p>Search the registered vendor/block directory by organization name substring and/or country. Returns registered, non-private blocks only. Counts as one call against your quota.</p>\n<p><code>total</code> is how many blocks match, independent of <code>limit</code>. Omitting both <code>query</code> and <code>country</code> matches the whole registry (about 58k non-private blocks), not an error. Docs: <a href=\"https://macadress.com/docs\">https://macadress.com/docs</a></p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"48eb792c-4670-401a-8f78-018e979e983b","id":"48eb792c-4670-401a-8f78-018e979e983b","name":"macadress.com MAC Address and OUI Vendor Lookup API","type":"collection"}},"urlObject":{"path":["v1","vendors"],"host":["https://api.macadress.com"],"query":[{"description":{"content":"<p>Optional. Substring match against organization name, case-insensitive.</p>\n","type":"text/plain"},"key":"query","value":"Apple"},{"description":{"content":"<p>Optional. Exact ISO 3166-1 alpha-2 code, e.g. US, DE, JP.</p>\n","type":"text/plain"},"key":"country","value":"US"},{"description":{"content":"<p>Optional. Max results, default 10, capped at 50.</p>\n","type":"text/plain"},"key":"limit","value":"10"}],"variable":[]}},"response":[{"id":"d7504dc6-54a2-47aa-bdab-4b1f79e46f1a","name":"200 matching blocks","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://api.macadress.com/v1/vendors?query=Apple&country=US&limit=10","host":["https://api.macadress.com"],"path":["v1","vendors"],"query":[{"key":"query","value":"Apple"},{"key":"country","value":"US"},{"key":"limit","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"total\": 1553,\n  \"blocks\": [\n    {\n      \"prefix_int\": 915,\n      \"mask_bits\": 24,\n      \"block_type\": \"MA-L\",\n      \"organization\": \"Apple, Inc.\",\n      \"address\": \"1 Infinite Loop Cupertino CA US 95014\",\n      \"country\": \"US\",\n      \"is_private\": false,\n      \"first_seen_at\": \"2026-08-22T14:26:39Z\",\n      \"last_changed_at\": \"2026-08-22T14:26:39Z\"\n    }\n  ]\n}"}],"_postman_id":"5b1d8253-3644-49cb-b5e1-a82b4c45fa04"}],"id":"a4b89e2f-f698-4998-aaf0-4aecbac2609f","description":"<p>The full JSON API. Set the <code>apiKey</code> collection variable first, or import the <code>macadress.com API</code> environment: get one free at <a href=\"https://macadress.com/signup\">https://macadress.com/signup</a>, copy it from <a href=\"https://macadress.com/account\">https://macadress.com/account</a>. It is sent automatically as <code>Authorization: Bearer </code>.</p>\n<p>Free plan: 30 requests/minute, 1,000 lookups per 30-day cycle. More at <a href=\"https://macadress.com/pricing\">https://macadress.com/pricing</a>.</p>\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["if (!pm.collectionVariables.get(\"apiKey\") && !pm.environment.get(\"apiKey\")) {","    console.warn(\"No apiKey set. Get a free key at https://macadress.com/signup and put it in the apiKey variable (or an environment).\");","}"],"id":"1e7a0261-3f20-439a-b24f-70af99338199"}}],"_postman_id":"a4b89e2f-f698-4998-aaf0-4aecbac2609f","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"48eb792c-4670-401a-8f78-018e979e983b","id":"48eb792c-4670-401a-8f78-018e979e983b","name":"macadress.com MAC Address and OUI Vendor Lookup API","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Runs after every request in the collection.","const dv = pm.response.headers.get(\"X-Data-Version\");","if (dv) { pm.collectionVariables.set(\"lastDataVersion\", dv); }","","pm.test(\"Response time is under 2000ms\", function () {","    pm.expect(pm.response.responseTime).to.be.below(2000);","});"],"id":"1f195e2e-d155-45b6-92cd-af9f2b0d57a7"}}],"variable":[{"key":"baseUrl","value":"https://api.macadress.com","description":"API host. No trailing slash."},{"key":"apiKey","value":"","description":"Your macadress.com API key (starts with mk_). Free key at https://macadress.com/signup, visible on https://macadress.com/account. Not needed for the Start here folder."},{"key":"sampleMac","value":"00:03:93:AB:12:34","description":"A MAC address to demo with. This one is an Apple MA-L block."},{"key":"sampleOui","value":"00:03:93","description":"A bare 24-bit OUI. The vendor name endpoint accepts this too."},{"key":"vendorQuery","value":"Apple","description":"Organization name substring for GET /v1/vendors."},{"key":"country","value":"US","description":"ISO 3166-1 alpha-2 country filter for GET /v1/vendors."},{"key":"lastVendorName","value":"","description":"Captured by the Vendor name request on a 200."},{"key":"lastOrganization","value":"","description":"Captured by the single MAC lookup when a vendor is found."},{"key":"lastDataVersion","value":"","description":"Captured from the X-Data-Version header on every response: the date the vendor database last synced."}]}