---
title: "Gets the structured log for a scheduled job"
method: GET
path: "/scheduler/{name}/logs"
tags: ["ScheduledJobs"]
---

# Gets the structured log for a scheduled job

`GET /scheduler/{name}/logs`

## Path parameters

- `name` string, required

## Query parameters

- `tail` integer
- `verbose` boolean

## Response `200`

The structured log for a scheduled job

- ScheduledTaskDetailsResource
  - `ActivityLog` ActivityLogTreeNode
    - `Children` ActivityLogTreeNode[]
    - `Ended` string, date-time
    - `Id` string
    - `LogElements` ActivityLogEntry[]
      - `Category` 'Trace' | 'Verbose' | 'Info' | 'Wait' | 'Highlight' | 'Gap' | 'Alert' | 'Warning' | 'Error' | 'Fatal' | 'Planned' | 'Updated' | 'Finished' | 'Abandoned' | 'Retry'
      - `Detail` string
      - `GapLastNumber` integer
      - `MessageText` string
      - `Number` integer
      - `OccurredAt` string, date-time
    - `Name` string
    - `ProgressMessage` string
    - `ProgressPercentage` integer
    - `ShowAtSummaryLevel` boolean
    - `Started` string, date-time
    - `Status` 'Pending' | 'Running' | 'Success' | 'Failed' | 'Skipped' | 'SuccessWithWarning' | 'Canceled'
  - `Id` string
  - `LastModifiedBy` string
  - `LastModifiedOn` string, date-time
  - `Links` object

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.net/octopus/apis/octopus-server-api.md) · [All operations](https://skmtc.net/octopus/apis/octopus-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octopus/octopus-server-api/versions/bc9158facfc7/schema)