s1.oddments.ai

{
  "properties": {
    "receipt": {
      "description": "Ed25519 reproducibility receipt over this exact request/response pair. Present on every response from both the paid and the free endpoint. Proves origin and integrity, not correctness. Verify with the public key at /.well-known/oddments-receipts.json and the script at /verify_receipt.py.",
      "properties": {
        "algorithm": {
          "description": "Ed25519",
          "type": "string"
        },
        "canonicalization": {
          "description": "the byte-exact rule used before signing",
          "type": "string"
        },
        "endpoint": {
          "description": "the path that produced the response",
          "type": "string"
        },
        "engine": {
          "description": "library and tzdata versions used, signed",
          "type": "object"
        },
        "input_sha256": {
          "description": "SHA-256 of the canonicalized request body",
          "type": "string"
        },
        "issued_at": {
          "description": "ISO-8601 UTC, signed",
          "type": "string"
        },
        "key_id": {
          "description": "first 16 hex chars of SHA-256(public_key_b64); identifies which signing key was used",
          "type": "string"
        },
        "output_sha256": {
          "description": "SHA-256 of the canonicalized response body with 'receipt' removed",
          "type": "string"
        },
        "price": {
          "description": "what was charged; 'free' on the preview endpoint",
          "type": "string"
        },
        "public_key_b64": {
          "description": "base64-encoded raw Ed25519 public key that verifies signature_b64. Not itself a signed field -- trust it only after checking it (or key_id) against the current or previous key published at /.well-known/oddments-receipts.json.",
          "type": "string"
        },
        "receipt_version": {
          "description": "currently 'oddments-receipt/1'",
          "type": "string"
        },
        "service": {
          "description": "the service name that issued this receipt, e.g. 'Recurrence Expander'",
          "type": "string"
        },
        "signature_b64": {
          "description": "base64-encoded Ed25519 signature over the canonical JSON of the fields named in signed_fields",
          "type": "string"
        },
        "signed_fields": {
          "description": "exactly which fields the signature covers",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "verify": {
          "description": "public key URL, verifier script URL, and what it does and does not prove",
          "type": "object"
        }
      },
      "required": [
        "receipt_version",
        "input_sha256",
        "output_sha256",
        "signature_b64",
        "signed_fields",
        "key_id",
        "algorithm"
      ],
      "type": "object"
    },
    "results": {
      "description": "one entry per input rule, in input order",
      "items": {
        "properties": {
          "anomalies": {
            "description": "the distinct occurrence flags seen across this rule's occurrences (nonexistent_local, ambiguous_local), sorted; empty if none",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "count": {
            "description": "number of occurrences returned for this rule",
            "type": "integer"
          },
          "crosses_dst_transition": {
            "description": "true if this rule's occurrences do not all share the same utc_offset, i.e. a DST transition falls within the expanded range",
            "type": "boolean"
          },
          "id": {
            "description": "echoed from the request",
            "type": "string"
          },
          "kind": {
            "description": "'cron' or 'rrule'",
            "type": "string"
          },
          "occurrences": {
            "description": "the expanded instants for this rule, in generation order, one per requested count",
            "items": {
              "properties": {
                "flags": {
                  "description": "e.g. nonexistent (spring forward), ambiguous (fall back)",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "is_dst": {
                  "description": "whether daylight saving was in effect at this occurrence",
                  "type": "boolean"
                },
                "local": {
                  "description": "ISO-8601 local wall time",
                  "type": "string"
                },
                "utc": {
                  "description": "exact UTC instant",
                  "type": "string"
                },
                "utc_offset": {
                  "description": "the UTC offset in effect at this occurrence, format +HH:MM or -HH:MM",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "tz": {
            "description": "the IANA zone this rule's occurrences were expanded in, echoed from the request",
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "total_occurrences": {
      "description": "sum of occurrence counts across all results in this response",
      "type": "integer"
    }
  },
  "required": [
    "results",
    "total_occurrences",
    "receipt"
  ],
  "type": "object"
}