---
title: "Read TargetList"
method: GET
path: "/TargetList/{id}"
tags: ["TargetList"]
---

# Read TargetList

`GET /TargetList/{id}`

Read an existing 'TargetList' record.

## Response `200`

Success.

- TargetList
  - `id` string — An ID.
  - `name` string — A one-line string.
  - `categoryId` string, nullable — An ID of the record of the TargetListCategory type.
  - `categoryName` string, nullable — A foreign record name.
  - `entryCount` integer, nullable
  - `optedOutCount` integer, nullable
  - `description` string, nullable — A multi-line text.
  - `sourceCampaignId` string, nullable
  - `sourceCampaignName` string, nullable — A foreign record name.
  - `createdAt` string, nullable — A timestamp in UTC.
  - `modifiedAt` string, nullable — A timestamp in UTC.
  - `createdById` string, nullable — An ID of the record of the User type.
  - `createdByName` string, nullable — A foreign record name.
  - `modifiedById` string, nullable — An ID of the record of the User type.
  - `modifiedByName` string, nullable — A foreign record name.
  - `assignedUserId` string, nullable — An ID of the record of the User type.
  - `assignedUserName` string, nullable — A foreign record name.
  - `teamsIds` string[], nullable — IDs of records of the Team type.
  - `teamsNames` object, nullable — An {ID => record name} map.
  - `targetStatus` 'Listed' | 'Opted Out'
  - `isOptedOut` boolean

## Other responses

- `403` — Forbidden. Might be an access control error. Check logs for details.

---

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