Get Specific Submission

GET/submissions/{token}{?base64_encoded,fields}

Returns details about submission.

Just like in create submission you can receive Base64 encoded data for every text type attribute (check the table to see which attributes are text type). By default, this parameter is set to false and Judge0 API will send you raw data.

By default Judge0 API is sending you 8 attributes for submission. As you may read in Submission section, submission model has 27 attributes. By sending fields query parameter you can specify exactly which attributes you want from Judge0 API.

Example URI

Content-Type: applicatiion/json

{
  "stdout": "hello, world\n",
  "status_id": 5,
  "language_id": 4,
  "stderr": null
}

Content-Type: application/json

{
  "stdout": "hello, Judge0\n",
  "time": "0.001",
  "memory": 376,
  "stderr": null,
  "token": "8531f293-1585-4d36-a34c-73726792e6c9",
  "compile_output": null,
  "message": null,
  "status": {
    "id": 3,
    "description": "Accepted"
  }
}

Content-Type: application/json

{
  "stdout": "aGVsbG8sIEp1ZGdlMAo=\n",
  "time": "0.002",
  "memory": 376,
  "stderr": null,
  "token": "4e00f214-b8cb-4fcb-977b-429113c81ece",
  "compile_output": null,
  "message": null,
  "status": {
    "id": 3,
    "description": "Accepted"
  }
}

Content-Type: application/json

{
    "status": 500,
    "error": "Internal Server Error",
    "exception": "#<Encoding::UndefinedConversionError: \"\x80\" from ASCII-8BIT to UTF-8>",
    ...
}

Get All Submissions

GET/submissions/{?base64_encoded,fields,page,per_page}

Example URI

Content-Type: application/json

{
  "submissions": [
    {
      "time": "0.001",
      "status": {
        "id": 3,
        "description": "Accepted"
      },
      "language": {
        "id": 4,
        "name": "C (gcc 7.2.0)"
      }
    },
    {
      "time": "0.001",
      "status": {
        "id": 3,
        "description": "Accepted"
      },
      "language": {
        "id": 4,
        "name": "C (gcc 7.2.0)"
      }
    }
  ],
  "meta": {
    "current_page": 4,
    "next_page": 5,
    "prev_page": 3,
    "total_pages": 31,
    "total_count": 62
  }
}

Content-Type: application/json

{
  "submissions": [
    {
      "stdout": "aGVsbG8sIEp1ZGdlMAo=\n",
      "time": "0.001",
      "memory": 376,
      "stderr": null,
      "token": "a1133bc6-a0f6-46bf-a2d8-6157418c6fe2",
      "compile_output": null,
      "message": null,
      "status": {
        "id": 3,
        "description": "Accepted"
      }
    },
    {
      "stdout": "aGVsbG8sIEp1ZGdlMAo=\n",
      "time": "0.001",
      "memory": 380,
      "stderr": null,
      "token": "eb0dd001-66db-47f4-8a69-b736c9bc23f6",
      "compile_output": null,
      "message": null,
      "status": {
        "id": 3,
        "description": "Accepted"
      }
    }
  ],
  "meta": {
    "current_page": 4,
    "next_page": 5,
    "prev_page": 3,
    "total_pages": 31,
    "total_count": 62
  }
}

Content-Type: application/json

{
  "error": "invalid page: -4"
}

Content-Type: application/json

{
  "error": "invalid per_page: -2"
}

List All Languages

GET/languages

Example URI

Content-Type: application/json

[
  {
    "id": 1,
    "name": "Bash (4.4)"
  },
  {
    "id": 2,
    "name": "Bash (4.0)"
  },
  {
    "id": 3,
    "name": "Basic (fbc 1.05.0)"
  },
  {
    "id": 4,
    "name": "C (gcc 7.2.0)"
  },
  {
    "id": 5,
    "name": "C (gcc 6.4.0)"
  },
  {
    "id": 6,
    "name": "C (gcc 6.3.0)"
  },
  {
    "id": 7,
    "name": "C (gcc 5.4.0)"
  },
  {
    "id": 8,
    "name": "C (gcc 4.9.4)"
  },
  {
    "id": 9,
    "name": "C (gcc 4.8.5)"
  },
  {
    "id": 10,
    "name": "C++ (g++ 7.2.0)"
  },
  {
    "id": 11,
    "name": "C++ (g++ 6.4.0)"
  },
  {
    "id": 12,
    "name": "C++ (g++ 6.3.0)"
  },
  {
    "id": 13,
    "name": "C++ (g++ 5.4.0)"
  },
  {
    "id": 14,
    "name": "C++ (g++ 4.9.4)"
  },
  {
    "id": 15,
    "name": "C++ (g++ 4.8.5)"
  },
  {
    "id": 16,
    "name": "C# (mono 5.4.0.167)"
  },
  {
    "id": 17,
    "name": "C# (mono 5.2.0.224)"
  },
  {
    "id": 18,
    "name": "Clojure (1.8.0)"
  },
  {
    "id": 19,
    "name": "Crystal (0.23.1)"
  },
  {
    "id": 20,
    "name": "Elixir (1.5.1)"
  },
  {
    "id": 21,
    "name": "Erlang (OTP 20.0)"
  },
  {
    "id": 22,
    "name": "Go (1.9)"
  },
  {
    "id": 23,
    "name": "Haskell (ghc 8.2.1)"
  },
  {
    "id": 24,
    "name": "Haskell (ghc 8.0.2)"
  },
  {
    "id": 25,
    "name": "Insect (5.0.0)"
  },
  {
    "id": 26,
    "name": "Java (OpenJDK 9 with Eclipse OpenJ9)"
  },
  {
    "id": 27,
    "name": "Java (OpenJDK 8)"
  },
  {
    "id": 28,
    "name": "Java (OpenJDK 7)"
  },
  {
    "id": 29,
    "name": "JavaScript (nodejs 8.5.0)"
  },
  {
    "id": 30,
    "name": "JavaScript (nodejs 7.10.1)"
  },
  {
    "id": 31,
    "name": "OCaml (4.05.0)"
  },
  {
    "id": 32,
    "name": "Octave (4.2.0)"
  },
  {
    "id": 33,
    "name": "Pascal (fpc 3.0.0)"
  },
  {
    "id": 34,
    "name": "Python (3.6.0)"
  },
  {
    "id": 35,
    "name": "Python (3.5.3)"
  },
  {
    "id": 36,
    "name": "Python (2.7.9)"
  },
  {
    "id": 37,
    "name": "Python (2.6.9)"
  },
  {
    "id": 38,
    "name": "Ruby (2.4.0)"
  },
  {
    "id": 39,
    "name": "Ruby (2.3.3)"
  },
  {
    "id": 40,
    "name": "Ruby (2.2.6)"
  },
  {
    "id": 41,
    "name": "Ruby (2.1.9)"
  },
  {
    "id": 42,
    "name": "Rust (1.20.0)"
  },
  {
    "id": 43,
    "name": "Text (plain text)"
  }
]

List All Statuses

GET/statuses

Example URI

Content-Type: application/json

[
  {
    "id": 1,
    "description": "In Queue"
  },
  {
    "id": 2,
    "description": "Processing"
  },
  {
    "id": 3,
    "description": "Accepted"
  },
  {
    "id": 4,
    "description": "Wrong Answer"
  },
  {
    "id": 5,
    "description": "Time Limit Exceeded"
  },
  {
    "id": 6,
    "description": "Compilation Error"
  },
  {
    "id": 7,
    "description": "Runtime Error (SIGSEGV)"
  },
  {
    "id": 8,
    "description": "Runtime Error (SIGXFSZ)"
  },
  {
    "id": 9,
    "description": "Runtime Error (SIGFPE)"
  },
  {
    "id": 10,
    "description": "Runtime Error (SIGABRT)"
  },
  {
    "id": 11,
    "description": "Runtime Error (NZEC)"
  },
  {
    "id": 12,
    "description": "Runtime Error (Other)"
  },
  {
    "id": 13,
    "description": "Internal Error"
  }
]

System Info

GET/system_info

System information gives you detailed information about system on which Judge0 API is running.

This information is result of two commands on a host system:

• lscpu

• free -h

Please note that Judge0 API consists of two systems: web and worker. Web system is the one who provides you the web API, and Worker is the one who processes your submissions. They can be placed on two or more different hosts with different system configurations. Result of this API request is always from web system. This means that this request might be irrelevant to you if you as user don’t know if web and worker are hosted on the same machine. To find that out, please contact admins who host Judge0 API you are using.

Example URI

Content-Type: application/json

{
  "Architecture": "x86_64",
  "CPU op-mode(s)": "32-bit, 64-bit",
  "Byte Order": "Little Endian",
  "CPU(s)": "4",
  "On-line CPU(s) list": "0-3",
  "Thread(s) per core": "2",
  "Core(s) per socket": "2",
  "Socket(s)": "1",
  "NUMA node(s)": "1",
  "Vendor ID": "GenuineIntel",
  "CPU family": "6",
  "Model": "61",
  "Model name": "Intel(R) Core(TM) i5-5200U CPU @ 2.20GHz",
  "Stepping": "4",
  "CPU MHz": "2508.703",
  "CPU max MHz": "2700.0000",
  "CPU min MHz": "500.0000",
  "BogoMIPS": "4392.12",
  "Virtualization": "VT-x",
  "L1d cache": "32K",
  "L1i cache": "32K",
  "L2 cache": "256K",
  "L3 cache": "3072K",
  "NUMA node0 CPU(s)": "0-3",
  "Mem": "7.7G",
  "Swap": "8.0G"
}

Configuration Info

GET/config_info

Configuration information gives you detailed information about configuration of Judge0 API. This configuration can be changed through judge0-api.conf file by admin who hosts Judge0 API instance.

This configuration gives every admin a flexibility to configure Judge0 API according to server abilities and needs. It also gives users insight on some default configuration values which are used when their programs are run.

Each of these configuration variables have default values which we consider as recommended in case you are not sure should you change them.

We will refer to default values as values which Judge0 API automatically assigns to each of these configuration variables, if admin didn’t set them. For example, default value of configuration variable cpu_time_limit is 2.

Default configuration value for each variable is given to you as response of this API call. For example, default configuration value for variable cpu_extra_time might be 2, and if admin didn’t set this, then it is 0.5 (default value). This means that admin set cpu_extra_time configuration variable to value 2 and we say it is now default configuration value for this variable cpu_extra_time.

Every submission can change each of the configuration variables according to its needs. For example, user might create submission which has cpu_time_limit of 5 seconds. For security reasons we need to limit values of each of these configuration variables. For example, we don’t want user to create a submission which has cpu_time_limit of 100000 seconds.

For this security reason we are introducing limit configuration variables for each configuration variable.

For example, max_cpu_time_limit with value 20 means that user cannot create new submission which has cpu_time_limit greater than 20.

Example URI

Content-Type: application/json

{
  "enable_wait_result": true,
  "cpu_time_limit": 2,
  "max_cpu_time_limit": 15,
  "cpu_extra_time": 0.5,
  "max_cpu_extra_time": 2,
  "wall_time_limit": 5,
  "max_wall_time_limit": 20,
  "memory_limit": 128000,
  "max_memory_limit": 256000,
  "stack_limit": 64000,
  "max_stack_limit": 128000,
  "max_processes_and_or_threads": 30,
  "max_max_processes_and_or_threads": 60,
  "enable_per_process_and_thread_time_limit": false,
  "allow_enable_per_process_and_thread_time_limit": true,
  "enable_per_process_and_thread_memory_limit": true,
  "allow_enable_per_process_and_thread_memory_limit": true,
  "max_file_size": 1024,
  "max_max_file_size": 4096,
  "number_of_runs": 1,
  "max_number_of_runs": 20
}

Workers Health Check

GET/workers

For each queue you will get:

• queue name

• total number of workers that has been initially run

• available number of workers

• how many workers are idle

• how many workers are currently working

• how many workers are paused

• how many jobs failed

Example URI

Content-Type: application/json

[
  {
    "queue": "default",
    "total": 1,
    "available": 1,
    "idle": 1,
    "working": 0,
    "paused": 0,
    "failed": 0
  }
]

Content-Type: application/json

[
  {
    "queue": "default",
    "total": 3,
    "available": 1,
    "idle": 1,
    "working": 0,
    "paused": 0,
    "failed": 0
  }
]