---
title: "Get Shared Template List"
method: GET
path: "/v1/template/share"
tags: ["templates"]
---

# Get Shared Template List

`GET /v1/template/share`

Shared template list

## Query parameters

- `fields` string
- `limit` integer
- `offset` integer
- `sort_asc` string
- `sort_desc` string

## Headers

- `X-Team-Id` string

## Response `200`

Example response

- object
  - `count` integer
  - `message` string, required
  - `total` integer
  - `results` SharedTemplateData[]
    - `uri` string — The URI of the template (could be a path or a ksuid)
    - `id` string — The ID of the template
    - `name` string — The name of the template
    - `author` string[] — The authors of the template
    - `tags` string[] — The tags of the template
    - `severity` string — The severity of the template
    - `type` string — The type of the template
    - `dir` string
    - `ref` string
    - `vendor` string — The vendor of the template
    - `product` string — The product of the template
    - `classification` Classification — Classification of template including additional metadata like cve-id, cwe-id etc
      - `cve-id` string[] — CVE IDs for the template
      - `cwe-id` string[] — CWE IDs for the template
      - `cvss-metrics` string — CVSS Metrics for the template
      - `cvss-score` number, float — CVSS Score for the template
      - `epss-score` number, float — EPSS Score for the template
      - `epss-percentile` number, float — EPSS Percentile for the template
      - `cpe` string — CPE for the template
    - `metadata` object
    - `digest` string — The digest of the template
    - `created_at` string, date-time — The time when template was created
    - `updated_at` string, date-time — The time when template was updated
    - `release_tag` string — The release tag of the template (contains tag when the file was first released)
    - `is_early` boolean — True if template is in early access
    - `raw` string — The raw unparsed template
    - `template_id` string
    - `description` string
    - `filename` string
    - `impact` string
    - `ai_meta` AIMeta
      - `model_used` string — The AI model used to generate the template
      - `is_prompt_by_human` boolean — Whether the prompt was written by a human
      - `is_template_by_human` boolean — Whether the template was written by a human
      - `prompt` string — The prompt used to generate the template
    - `references` string[]
    - `template_type` 'public' | 'user' | 'shared'
    - `is_draft` boolean
    - `is_github` boolean
    - `is_new` boolean
    - `is_pdteam` boolean — Is the template from pdteam
    - `remediation` string
    - `ttl` string — Time to live duration (1d ,1m etc)
    - `share_type` string — Type of share (unlisted, users, organization)
    - `users_email` string[] — List of email addresses or user IDs to share with (required if share_type is set to 'users')
    - `organizations` string[]

## Other responses

- `400` — Example response
- `401` — Example response
- `404` — Example response
- `500` — Example response
- `default` — Example response

## Changes

- **2025-10-28** `c9df54e2fb2c` — 2 warning
  - removed the optional property `results/items/allOf[#/components/schemas/TemplateData]/is_pdresearch` from the response with the `200` status
  - removed the optional property `results/items/allOf[#/components/schemas/TemplateData]/is_pdtemplate` from the response with the `200` status
- **2025-08-13** `c41cd7ae7718` — 12 warning, 8 info
  - deleted the `query` request parameter `template_id`
  - deleted the `query` request parameter `user_name`
  - removed the optional property `is_public` from the response with the `200` status
  - removed the optional property `is_public` from the response with the `400` status
  - …16 more
- **2024-09-22** `407b73d9ce28` — 1 info
  - added the new optional `header` request parameter `X-Team-Id`
- **2024-01-31** `4f557b176ebd` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
- **2023-12-06** `35be9c1301b7` — 1 info
  - api tag `templates` added

[Full history](https://skmtc.dev/projectdiscovery/apis/pdcp-api/changes/v1/template/share/get.md)

---

[API](https://skmtc.dev/projectdiscovery/apis/pdcp-api.md) · [All operations](https://skmtc.dev/projectdiscovery/apis/pdcp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/projectdiscovery/pdcp-api/revisions/220f0adf9efd/schema)