# UUIDv7 Idempotency Key Generator

> UUIDv7 Idempotency Key Generator is a paid API for AI agents from api.ibancheck.co.uk, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-13).

Generates a time-sortable UUIDv7-based idempotency key with a deterministic payload hash to enable safe retries of paid API calls without double-charging.

## Facts

- Endpoint: POST https://api.ibancheck.co.uk/api/generate-idempotency-key?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uuidv7-idempotency-key-generator-651b6330
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ACTLakys6Wf2rVuNeRJcO

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 uuidv7-idempotency-key-generator-651b6330 -d '<json body>'
```

Example prompt: Generate an idempotency key for my invoice-creation request scoped to 'invoices', using my payload object, and set a TTL of 3600 seconds so I can safely retry without being charged again.

## When to prefer this

Use this endpoint whenever you need to safely retry any paid API call on api.ibancheck.co.uk without risking duplicate charges. It is especially valuable in unreliable network conditions, automated agent workflows, or batch processing where the same request may be submitted more than once. Prefer this over client-side UUID generation when you need the key to be deterministically bound to the request payload.

## Known failure modes

- Missing or malformed payload object may result in hash generation failure
- Invalid or negative ttlSeconds value may cause key creation to fail
- Scope string exceeding allowed length may be rejected
- Network timeout or service unavailability may return 5xx
- Reusing an expired idempotency key may result in a new charge on the next call

## How this service works

Enterprise microservice and autonomous AI agent hub: ISO 13616 IBAN (#6), Romanian CUI Modulo-11 & EU VIES (#7), UBL 2.1 e-Factura XML (#4), and RFC 9562 UUIDv7 Idempotency (#18).

## Output

Returns a UUIDv7-based idempotency key string (time-sortable) and a deterministic SHA-256 hash of the submitted payload, along with expiry metadata based on the ttlSeconds provided. This key can be sent as the Idempotency-Key HTTP header on any retried call to a paid endpoint on the platform to retrieve the cached response without incurring a new charge.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "scope": {
   "type": "string"
  },
  "payload": {
   "type": "object"
  },
  "ttlSeconds": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uuidv7-idempotency-key-generator-651b6330/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ibancheck.co.uk](https://www.zero.xyz/host/api.ibancheck.co.uk/llms.txt)