{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/pricklymails-com/json-schema/pricklymails-com-list-jobs-response-schema.json",
  "title": "ListJobsResponse",
  "description": "JSON response body for `GET /api/jobs`.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/pricklymails-com-jobs-api-openapi.yml#/components/schemas/ListJobsResponse",
  "type": "object",
  "required": [
    "jobs",
    "limit",
    "offset"
  ],
  "properties": {
    "jobs": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/JobItem"
      },
      "description": "List of jobs, newest first."
    },
    "limit": {
      "type": "integer",
      "format": "int64",
      "description": "Pagination limit used for this page (effective after clamping)."
    },
    "offset": {
      "type": "integer",
      "format": "int64",
      "description": "Pagination offset used for this page."
    }
  },
  "$defs": {
    "JobItem": {
      "type": "object",
      "description": "A single job summary item in the response list.",
      "required": [
        "uuid",
        "status",
        "email_count",
        "created_at"
      ],
      "properties": {
        "created_at": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601 creation timestamp."
        },
        "email_count": {
          "type": "integer",
          "format": "int32",
          "description": "Number of email addresses associated with this job.\nRaw email addresses are never stored (zero-retention policy); only the count is surfaced.",
          "minimum": 0
        },
        "error": {
          "type": [
            "string",
            "null"
          ],
          "description": "The job's failure reason, populated only when the job's lifecycle status is `\"failed\"`.\n`null` for every other job."
        },
        "score": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int32",
          "description": "Quality score (0-100) of the job's sole verification.\nPopulated only for a single-email job (`email_count == 1`) whose email already has a result; `null` for\nmulti-email jobs (no single representative verdict) and for results still pending.",
          "minimum": 0
        },
        "status": {
          "type": "string",
          "description": "Current lifecycle status (e.g. `\"pending\"`, `\"completed\"`)."
        },
        "uuid": {
          "type": "string",
          "description": "Public UUID of the job."
        },
        "verdict": {
          "type": [
            "string",
            "null"
          ],
          "description": "Deliverability verdict of the job's sole verification (e.g. `\"valid\"`, `\"risky\"`), the same stable strings\n`POST /api/verify` returns. `null` under the same condition as `score`."
        }
      }
    }
  }
}