Spring Batch · Schema

Spring Batch Job Execution

Represents the execution of a Spring Batch job instance. Contains all metadata about a single run of a job including timing, status, and step execution details.

Batch ProcessingData ProcessingEnterpriseETLJavaJob SchedulingSpring Framework

Properties

Name	Type	Description
id	integer	Unique identifier for this job execution.
jobId	integer	Identifier of the job instance this execution belongs to.
jobName	string	Name of the job being executed.
startTime	string	Timestamp when the job execution started.
endTime	string	Timestamp when the job execution ended. Null if still running.
status	string	Current batch status of the job execution.
exitCode	string	Exit code indicating the final state. Typically COMPLETED, FAILED, or a custom exit code.
exitDescription	string	Human-readable description of the exit condition, including any exception messages.
jobParameters	object	Parameters used to identify and parameterize this job execution.
stepExecutions	array	List of step execution records for each step run during this job execution.
createTime	string	Timestamp when this job execution record was created in the job repository.
lastUpdated	string	Timestamp of the most recent update to this execution record.
version	integer	Optimistic locking version number for the job execution record.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://spring.io/schema/batch/5.1/job-execution",
  "title": "Spring Batch Job Execution",
  "description": "Represents the execution of a Spring Batch job instance. Contains all metadata about a single run of a job including timing, status, and step execution details.",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Unique identifier for this job execution.",
      "format": "int64"
    },
    "jobId": {
      "type": "integer",
      "description": "Identifier of the job instance this execution belongs to.",
      "format": "int64"
    },
    "jobName": {
      "type": "string",
      "description": "Name of the job being executed.",
      "example": "importUserJob"
    },
    "startTime": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the job execution started."
    },
    "endTime": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the job execution ended. Null if still running."
    },
    "status": {
      "type": "string",
      "description": "Current batch status of the job execution.",
      "enum": ["COMPLETED", "STARTING", "STARTED", "STOPPING", "STOPPED", "FAILED", "ABANDONED", "UNKNOWN"]
    },
    "exitCode": {
      "type": "string",
      "description": "Exit code indicating the final state. Typically COMPLETED, FAILED, or a custom exit code.",
      "example": "COMPLETED"
    },
    "exitDescription": {
      "type": "string",
      "description": "Human-readable description of the exit condition, including any exception messages."
    },
    "jobParameters": {
      "type": "object",
      "description": "Parameters used to identify and parameterize this job execution.",
      "additionalProperties": {
        "type": "string"
      },
      "example": {
        "run.id": "1",
        "input.file": "data/users-2026-05-02.csv"
      }
    },
    "stepExecutions": {
      "type": "array",
      "description": "List of step execution records for each step run during this job execution.",
      "items": {
        "$ref": "#/$defs/StepExecution"
      }
    },
    "createTime": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when this job execution record was created in the job repository."
    },
    "lastUpdated": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp of the most recent update to this execution record."
    },
    "version": {
      "type": "integer",
      "description": "Optimistic locking version number for the job execution record."
    }
  },
  "required": ["id", "jobName", "status"],
  "$defs": {
    "StepExecution": {
      "title": "Step Execution",
      "description": "Represents the execution of a single step within a job execution.",
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int64",
          "description": "Unique identifier for this step execution."
        },
        "stepName": {
          "type": "string",
          "description": "Name of the step.",
          "example": "importStep"
        },
        "status": {
          "type": "string",
          "description": "Current batch status of the step execution.",
          "enum": ["COMPLETED", "STARTING", "STARTED", "STOPPING", "STOPPED", "FAILED", "ABANDONED", "UNKNOWN"]
        },
        "readCount": {
          "type": "integer",
          "description": "Number of items successfully read.",
          "minimum": 0
        },
        "writeCount": {
          "type": "integer",
          "description": "Number of items successfully written.",
          "minimum": 0
        },
        "commitCount": {
          "type": "integer",
          "description": "Number of chunk commits.",
          "minimum": 0
        },
        "rollbackCount": {
          "type": "integer",
          "description": "Number of chunk rollbacks.",
          "minimum": 0
        },
        "readSkipCount": {
          "type": "integer",
          "description": "Number of items skipped during reading.",
          "minimum": 0
        },
        "processSkipCount": {
          "type": "integer",
          "description": "Number of items skipped during processing.",
          "minimum": 0
        },
        "writeSkipCount": {
          "type": "integer",
          "description": "Number of items skipped during writing.",
          "minimum": 0
        },
        "filterCount": {
          "type": "integer",
          "description": "Number of items filtered by an ItemProcessor returning null.",
          "minimum": 0
        },
        "startTime": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp when this step execution started."
        },
        "endTime": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp when this step execution ended."
        },
        "exitCode": {
          "type": "string",
          "description": "Exit code for the step execution.",
          "example": "COMPLETED"
        },
        "exitDescription": {
          "type": "string",
          "description": "Exit description message for the step."
        }
      },
      "required": ["id", "stepName", "status"]
    }
  }
}