---
title: "List Projects"
method: GET
path: "/projects"
tags: ["Project"]
---

# List Projects

`GET /projects`

## Request

- Base URL: `https://api.securitytrails.com/v2`
- URL: `https://api.securitytrails.com/v2/projects`
- Auth: API key in header `apikey`

Retrieve the projects your user has access to.

## Query parameters

- `sort_direction` 'asc' | 'desc'

## Response `200`

Successful Response

- ProjectListResponse
  - `data` Project[], required
    - `id` string, uuid, required
    - `title` string, required
    - `scanning_enabled` boolean, nullable
    - `last_scanned_at` string, date-time, nullable
    - `inserted_at` string, date-time, nullable
    - `max_exposure_score` integer, nullable
  - `meta` ApiMeta, required
    - `params` object, nullable
    - `counts` ApiCount
      - `total` integer, nullable
      - `returned` integer, required
    - `pagination` PaginationResponse
      - `next_cursor` string, nullable: An opaque value which should be passed as the `cursor` to retrieve the nextpage of results
      - `limit` integer, nullable: The number of items returned
      - `total` integer, nullable
      - `sort` array[], nullable: The sort order of the results
        - unknown[]
          - unknown
    - `request_id` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/recordedfuture/apis/attack-surface-intelligence.md) - [All operations](https://skmtc.dev/recordedfuture/apis/attack-surface-intelligence/llms.txt) - [OpenAPI document](https://skmtc.dev/recordedfuture/apis/attack-surface-intelligence/revisions/7fd5c7304957?raw)