Documentation

API URL


GET /api/v1/mac-address

Headers
Code
Content-Type: application/json
Query Parameters


Example GET Request

Code
GET https://datpaq.com/api/v1/mac-address?api_key=your-api-key&prefix=00:1A:2B

Successful Response

Status
HTML
200 OK
Body
Code
{
  "success": true,
  "count": 1,
  "data": [
    {
      "prefix": "001122",
      "organization": "Apple, Inc.",
      "address": "1 Apple Park Way, Cupertino CA 95014, US"
    }
  ],
  "mac_address": "00:11:22:33:44:55",
  "vendor": "Apple, Inc."
}

Error Response

Example
Code
400 ValidationError - Invalid mac input format: MAC lookup input failed format validation
400 ValidationError - Invalid prefix input format: Prefix lookup requires exactly 6 hex characters
400 ValidationError - Organization search term too short: Organization search requires at least 2 characters
400 ValidationError - No lookup parameter provided: Request must include mac prefix or org query key
404 NotFound - Lookup criteria not found in dataset: No rows matched in external.mac_prefixes
500 InternalServerError - Database or runtime failure during lookup: Service failed while processing request
503 ServiceUnavailable - Database pool unavailable: Service cannot execute lookup without DB connectivity

Last Updated:  May 4, 2026