Can I search by vendor name instead of a MAC address?
Yes. Pass org with at least two characters for a case-insensitive partial match. Results are capped at 50 registry entries.
MAC Address API
IEEE OUI
3 query modes
Vendor analytics
Who made this device?Trace any MAC to its vendor.
Identify network hardware manufacturers from full MAC addresses, OUI prefixes, or organization name searches. Official IEEE registry data with format normalization and hardware classification.
mac · full addressprefix · 6-char OUIorg · vendor searchIEEE · registry
Why MAC Address API
Vendor intel from any MAC.
Full MAC Lookup
Pass a complete MAC in colon, hyphen, or compact hex format. Returns vendor, prefix, and analytics.
OUI Prefix Search
Query exactly six hex characters for the IEEE-assigned organization block behind a prefix.
Organization Discovery
Search by vendor name substring (min 2 chars). Up to 50 matching registry entries per request.
Format Normalization
Input is normalized before lookup — no need to pre-format MAC strings in your client code.
IEEE Registry Data
Manufacturer name, registry classification, and assignment address from the official OUI database.
Hardware Classification
Analytics include vendor detection flags and hardware classification hints for security workflows.
/api/v1/mac-address
Endpoints, at a glance.
One GET route with three mutually exclusive query modes. No POST or batch endpoint.
GET/mac-address
MAC vendor lookup
Provide exactly one of `mac`, `prefix` (6 hex chars), or `org` (min 2 chars). Returns IEEE registry matches with vendor analytics.
PRIMARY
GET/mac-address/health
Service health
Database connectivity and service status.
GET/mac-address/metrics
Prometheus metrics
Lookup counters, query modes, and database health metrics.
| Parameter | Type | Required | Description |
|---|---|---|---|
| mac | string | one of three | Full MAC address, e.g. "00:11:22:33:44:55". |
| prefix | string | one of three | Exactly 6 hex characters for OUI prefix lookup, e.g. 001122. |
| org | string | one of three | Organization name substring (min 2 chars). Returns up to 50 matches. |
Requests & responses.
Query by full MAC for vendor analytics, or search by organization name for discovery.
Full MAC lookup
Vendor, prefix, and hardware classification.
GET https://datpaq.com/api/v1/mac-address?mac=00:11:22:33:44:55
Organization search
Partial vendor name match, up to 50 results.
GET https://datpaq.com/api/v1/mac-address?org=Apple
Health
https://datpaq.com/api/v1/mac-address/health
Metrics
https://datpaq.com/api/v1/mac-address/metrics
Error reference
Predictable errors, always structured.
Validation failures return clear messages before any registry query runs.
400Missing Parameter
None of mac, prefix, or org was provided. Pass exactly one query parameter.
400Invalid MAC Format
MAC address could not be parsed. Use colon, hyphen, or compact hex notation.
400Invalid Prefix
OUI prefix must be exactly 6 hexadecimal characters.
400Organization Too Short
org search requires at least 2 characters.
401Unauthorized
API key missing or invalid. Pass as x-api-key header or api_key query parameter.
404No Match Found
No IEEE registry entry matched the provided MAC or prefix.
FAQ
API questions developers ask first.
What MAC address formats are accepted?
Colon-separated (00:11:22:33:44:55), hyphen-separated, or compact hex (001122334455). The API normalizes input before lookup.
How do I authenticate with this API?
Create an API key in your Datpaq dashboard and send it with each request as a bearer token in the Authorization header.
Is there a free tier?
Yes. Datpaq APIs include a free tier for building, testing, and small production workloads before you move to a paid plan.
What format do requests and responses use?
Datpaq APIs use REST over HTTPS and return JSON by default. Endpoint docs show the supported methods, query parameters, request bodies, and response fields.
Where can I see limits and errors?
Each API documents rate limits, validation rules, and error responses in the landing page and API docs so integrations can retry and fail cleanly.
Hardware vendor intel, on demand.
Identify network devices by MAC address using official IEEE OUI registry data — ideal for security audits and asset inventory.