---
title: "Get-TaskSubscriber"
slug: "scripting-get-task-subscriber"
updated: 2025-07-16T15:07:37Z
published: 2025-07-16T15:07:37Z
canonical: "help.agilityblue.com/scripting-get-task-subscriber"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.agilityblue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get-TaskSubscriber

## Summary

Retrieves an existing task subscriber.

```powershell
Get-TaskSubscriber
    -Id
    -IncludeTask
    -IncludeUser
```

Returns a [task subscriber](https://apidocs.agilityblue.com/#b96d5a03-930f-4537-8b6e-16df54e0304e) object.

## Parameters

| Parameter | Type | Required? | Notes |
| --- | --- | --- | --- |
| Id | Int32 | Yes | The task subscriber id. |
| IncludeTask | Switch | No, defaults to `False` | Includes the `Task` property details. |
| IncludeUser | Switch | No, defaults to `False` | Includes `User` property details. |

## Examples

### Get an existing task subscriber

This example retrieves a specific task subscriber and outputs it as JSON.

```powershell
# Retrieve a specific task subscriber by id
$entity = Get-TaskSubscriber -Id 13

Write-Output "Retrieved task subscriber $($entity.TaskSubscriberId)"

# For debug purposes, convert the task to output as JSON so we can see the available fields
Write-Output ""
Write-Output "JSON Results:"

$jsonOutput = $entity | ConvertTo-Json -Depth 10

# Output the task
Write-Output $jsonOutput
```

Execution results:

```json
Retrieved task subscriber 13

JSON Results:
{
  "TaskSubscriberId": 13,
  "TaskId": 517,
  "TaskName": "Load data",
  "Task": null,
  "UserId": "510e109b-6ff5-4442-9670-cd5e3cd82a7a",
  "User": null,
  "UserFullName": "Max Miller",
  "UserEmail": "mmiller@agilityblue.com",
  "UserNotificationsEnabled": true,
  "UserIsTeamAccount": false,
  "AdditionalInformation": null,
  "CreatedByFullName": "Max Miller",
  "CreatedById": "510e109b-6ff5-4442-9670-cd5e3cd82a7a",
  "CreatedOn": "2019-03-11T14:46:11.5687565-05:00",
  "CreatedBy": null
}
```