---
title: "Service: /threads [GET]"
source: https://dev.pageseeder.com/api/services/list-server-threads-GET.html
description: "GET endpoint that lists all active asynchronous processes on the server. Requires administrator permission. Returns XML with thread details including ID, name, username, group ID, and status."
last_updated: 2026-09-02T11:36:04+10:00
document_type: api_endpoint
operation_id: thread-GET
resource_id: thread
path_template: /threads
http_method: GET
api_category: thread
implementation_version: 5.0100
api_since: 4.9500
deprecated_since: null
obsolete_since: null
api_support: experimental
cache_control: null
generated_at: 2026-09-02
tokens: ~221
---

# /threads \[GET\]

## Description

List All Threads.

This service lists each active [Asynchronous process](../usage/asynchronous_process.md) on the server.

## Parameters

No parameters required.

## Permission

This service requires administrator.

## Response

This service returns the following XML:

```xml

<threads>
  <thread id="[thread id]"
          name="[thread name]"
          username="[username of user starting thread]"
          groupid="[ID of group if applicable or -1]"
          status="[initialised|
                   inprogress|
                   error|
                   warning|
                   cancelled|
                   failed|
                   complete]">
          [<message>[explanation or error]<message>]
          [thread specific XML]
  </thread>
  ...
</threads>
```

## Error Handling

No specific errors expected for this service.