> ## Documentation Index > Fetch the complete documentation index at: https://docs.quedup.dev/llms.txt > Use this file to discover all available pages before exploring further. # List Job Runs > Returns execution history for a job using keyset pagination, including response details for each run. ## OpenAPI ````yaml /openapi.json get /jobs/{id}/run openapi: 3.0.3 info: title: QuedUp API description: Development documentation version: 0.1.0 servers: - url: https://api.quedup.dev description: Production API security: [] tags: - name: Jobs description: Job management endpoints. paths: /jobs/{id}/run: get: tags: - Jobs summary: List Job Runs description: >- Returns execution history for a job using keyset pagination, including response details for each run. operationId: getJobsByIdRun parameters: - name: id in: path required: true schema: description: Unique identifier of the job. example: 550e8400-e29b-41d4-a716-446655440000 type: string - name: cursor in: query required: false schema: description: Opaque pagination cursor returned from a previous list response. example: >- eyJjcmVhdGVkX2F0IjoiMjAyNi0wMy0wOVQwMDowMDowMi40ODFaIiwiaWQiOiI2NjBlODQwMC1lMjliLTQxZDQtYTcxNi00NDY2NTU0NDAwMDEifQ type: string responses: '200': description: Paginated list of recorded runs for a job. content: application/json: schema: example: data: - id: 660e8400-e29b-41d4-a716-446655440001 attempt: 1 target_run_at: '2026-03-09T00:00:00.000Z' run_at: '2026-03-09T00:00:02.104Z' completed_at: '2026-03-09T00:00:02.481Z' duration_ms: 377 status: success response_status_code: 200 response_headers: content-type: application/json; charset=utf-8 x-request-id: req_1234567890 response_body: '{"ok":true}' has_more: false next_cursor: null type: object required: - data - has_more - next_cursor properties: data: description: Execution attempts returned for the current page. example: - id: 660e8400-e29b-41d4-a716-446655440001 attempt: 1 target_run_at: '2026-03-09T00:00:00.000Z' run_at: '2026-03-09T00:00:02.104Z' completed_at: '2026-03-09T00:00:02.481Z' duration_ms: 377 status: success response_status_code: 200 response_headers: content-type: application/json; charset=utf-8 x-request-id: req_1234567890 response_body: '{"ok":true}' type: array items: description: A recorded execution attempt for a job. example: id: 660e8400-e29b-41d4-a716-446655440001 attempt: 1 target_run_at: '2026-03-09T00:00:00.000Z' run_at: '2026-03-09T00:00:02.104Z' completed_at: '2026-03-09T00:00:02.481Z' duration_ms: 377 status: success response_status_code: 200 response_headers: content-type: application/json; charset=utf-8 x-request-id: req_1234567890 response_body: '{"ok":true}' type: object required: - id - attempt - target_run_at - run_at - completed_at - duration_ms - status - response_status_code - response_headers - response_body properties: id: description: Unique identifier for this execution attempt. example: 660e8400-e29b-41d4-a716-446655440001 type: string attempt: description: Retry attempt number for this execution. example: 1 type: number target_run_at: description: >- Scheduled execution time for this run in ISO 8601 format. format: date-time example: '2026-03-09T00:00:00.000Z' type: string run_at: description: Actual execution start time in ISO 8601 format. format: date-time example: '2026-03-09T00:00:02.104Z' type: string completed_at: nullable: true description: >- Execution completion time in ISO 8601 format, if finished. format: date-time example: '2026-03-09T00:00:02.481Z' type: string duration_ms: nullable: true description: Execution duration in milliseconds, if completed. example: 377 type: number status: type: string enum: - success - failed - timeout - limit_reached description: Outcome of the execution attempt. example: success response_status_code: nullable: true description: >- HTTP status code returned by the target endpoint, if a response was received. example: 200 type: number response_headers: nullable: true description: >- Response headers returned by the target endpoint, if available. example: content-type: application/json; charset=utf-8 x-request-id: req_1234567890 type: object additionalProperties: {} response_body: nullable: true description: >- Response body returned by the target endpoint, if available. example: '{"ok":true}' type: string has_more: description: Whether another page of results is available. example: false type: boolean next_cursor: nullable: true description: Opaque cursor to request the next page of results. example: >- eyJjcmVhdGVkX2F0IjoiMjAyNi0wMy0wOVQwMDowMDowMi40ODFaIiwiaWQiOiI2NjBlODQwMC1lMjliLTQxZDQtYTcxNi00NDY2NTU0NDAwMDEifQ type: string '400': description: Standard error payload returned when a request cannot be completed. content: application/json: schema: example: error: invalid_request message: url must be a valid http(s) URL field: url type: object required: - error - message properties: error: description: Stable machine-readable error code. example: invalid_request type: string message: description: Human-readable explanation of the error. example: url must be a valid http(s) URL type: string field: description: >- Request field associated with the validation error, when applicable. example: url type: string '404': description: Standard error payload returned when a request cannot be completed. content: application/json: schema: example: error: invalid_request message: url must be a valid http(s) URL field: url type: object required: - error - message properties: error: description: Stable machine-readable error code. example: invalid_request type: string message: description: Human-readable explanation of the error. example: url must be a valid http(s) URL type: string field: description: >- Request field associated with the validation error, when applicable. example: url type: string '500': description: Standard error payload returned when a request cannot be completed. content: application/json: schema: example: error: invalid_request message: url must be a valid http(s) URL field: url type: object required: - error - message properties: error: description: Stable machine-readable error code. example: invalid_request type: string message: description: Human-readable explanation of the error. example: url must be a valid http(s) URL type: string field: description: >- Request field associated with the validation error, when applicable. example: url type: string security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API key description: >- Provide your QuedUp API key in the Authorization header as `Bearer `. ````