# UUID Inspector

> UUID Inspector is a paid API for AI agents from uuid.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-21).

Parses and validates any UUID string, returning its version, variant, embedded timestamp (for v1/v6/v7), nil/max flags, and normalized hex/URN representations.

## Facts

- Endpoint: GET https://uuid.use.x402atlas.com/inspect?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uuid-inspector-21d853a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OwQ2_feKga2Cm7tUIY-ww

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability uuid-inspector-21d853a7
```

Example prompt: Can you inspect this UUID for me — 018f4e3a-9b2c-7d1e-8a3b-4c5d6e7f8a9b — and tell me what version it is, whether it has an embedded timestamp, and its URN form?

## When to prefer this

Choose this endpoint when you need to programmatically parse, validate, or introspect a UUID — especially to recover the embedded creation timestamp from UUIDv7, v6, or v1 keys, or to normalize UUID strings across different input formats (canonical, braces, URN, hex). Prefer this over manual parsing when you need version/variant detection, nil/max detection, or multi-format normalization in a single call.

## Known failure modes

- Malformed or non-UUID input string returns an error indicating the UUID could not be parsed
- UUID in an unrecognized format (not canonical, braces, URN, or 32-hex) may fail to parse
- Timestamp fields are empty/zero for UUID versions other than 1, 6, or 7 — not an error but may surprise callers expecting a timestamp from a v4 UUID
- Payment failure or insufficient USDC balance returns a 402 response before the UUID is processed

## How this service works

UUID inspector — parses any UUID (canonical, braces, URN or 32-hex form) and returns its version, variant, embedded timestamp for v1/v6/v7, nil/max flags, hex and URN forms. Use to validate identifiers or recover the creation time of UUIDv7 keys.

## Output

Returns a JSON object with the normalized lowercase canonical UUID, its version number (0–15), variant label (rfc4122, ncs, microsoft, future, or invalid), embedded timestamp as RFC 3339 UTC string and Unix milliseconds (populated for v1/v6/v7, otherwise empty/0), boolean flags for nil and max UUIDs, 32-character lowercase hex string, and urn:uuid: form.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "uuid"
     ],
     "properties": {
      "uuid": {
       "type": "string",
       "maxLength": 45,
       "description": "UUID in canonical, {braces}, urn:uuid: or 32-hex form, any case. Defaults to the example when omitted."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "uuid",
      "version",
      "variant",
      "timestamp",
      "timestamp_ms",
      "is_nil",
      "is_max",
      "hex",
      "urn"
     ],
     "properties": {
      "hex": {
       "type": "string",
       "description": "32 lowercase hex digits, no dashes."
      },
      "urn": {
       "type": "string",
       "description": "urn:uuid:<canonical> form."
      },
      "uuid": {
       "type": "string",
       "format": "uuid",
       "description": "Normalized lowercase canonical form."
      },
      "is_max": {
       "type": "boolean",
       "description": "True for ffffffff-ffff-ffff-ffff-ffffffffffff."
      },
      "is_nil": {
       "type": "boolean",
       "description": "True for 00000000-0000-0000-0000-000000000000."
      },
      "variant": {
       "enum": [
        "rfc4122",
        "ncs",
        "microsoft",
        "future",
        "invalid"
       ],
       "type": "string",
       "description": "Layout family; rfc4122 for standard UUIDs."
      },
      "version": {
       "type": "integer",
       "maximum": 15,
       "minimum": 0,
       "description": "Version nibble; 0 for the nil and max UUIDs."
      },
      "timestamp": {
       "type": "string",
       "description": "Embedded creation time, RFC 3339 UTC; empty unless version is 1, 6 or 7."
      },
      "timestamp_ms": {
       "type": "integer",
       "description": "Embedded creation time in Unix milliseconds; 0 unless version is 1, 6 or 7."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uuid-inspector-21d853a7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from uuid.use.x402atlas.com](https://www.zero.xyz/host/uuid.use.x402atlas.com/llms.txt)