# UUID v4 Generator (uuid-forge.saastemly.com)

> UUID v4 Generator (uuid-forge.saastemly.com) is a paid API for AI agents from uuid-forge.saastemly.com, paid per call via x402, $0.0017/call, status unknown (last checked 2026-10-20).

Generates 1–100 random UUID v4 strings in multiple formats (canonical, URN, hex, or 128-bit integer) via a simple GET request.

## Facts

- Endpoint: GET https://uuid-forge.saastemly.com/v1/uuid?utm_source=zero.xyz
- Price: $0.0017/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uuid-v4-generator-uuid-forge-saastemly-com-d7e8ce83
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_S9RFJlSMF45OrMvOe-t6A

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-v4-generator-uuid-forge-saastemly-com-d7e8ce83
```

Example prompt: Give me 5 random UUID v4s in URN format so I can use them as unique identifiers in my test data.

## When to prefer this

Choose this endpoint when you need one or more RFC 9562-compliant UUID v4 strings with flexible output formatting (canonical, URN, hex, or integer) and want a simple stateless GET call. It supports batch generation of up to 100 UUIDs per request, making it efficient for seeding test data or provisioning IDs in bulk. Prefer it over rolling your own UUID generation when you need a pay-per-call microservice with no setup, or when your runtime environment lacks a reliable UUID library.

## Known failure modes

- count out of range (< 1 or > 100) — likely returns 400 or validation error
- invalid format enum value — returns 400 bad request
- count parameter not a valid integer string — validation fails per pattern constraint
- payment not provided or insufficient — returns 402 Payment Required (x402 protocol)
- rate limit exceeded — returns 429

## How this service works

Returns 1-100 random UUID v4 strings (RFC 9562): ?count=1..100 (default 1), ?format=uuid|urn|hex|int (default uuid).

## Output

Returns a JSON response containing an array of 1–100 UUID v4 strings. Each UUID is formatted according to the requested format: canonical 8-4-4-4-12 (uuid), urn:uuid:-prefixed (urn), 32 lowercase hex digits without dashes (hex), or a 128-bit decimal integer string (int). If count and format are omitted, a single canonical UUID is returned.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "count": {
       "type": "string",
       "pattern": "^[0-9]+$",
       "description": "How many UUIDs to return, 1-100 (default 1)"
      },
      "format": {
       "enum": [
        "uuid",
        "urn",
        "hex",
        "int"
       ],
       "type": "string",
       "description": "uuid: canonical 8-4-4-4-12 (default); urn: urn:uuid: prefix; hex: 32 hex digits; int: 128-bit decimal"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uuid-v4-generator-uuid-forge-saastemly-com-d7e8ce83/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from uuid-forge.saastemly.com](https://www.zero.xyz/host/uuid-forge.saastemly.com/llms.txt)