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

# List Projects (v1.5)

> List every Project in your account with its validation status

Returns a paginated collection: `Data` is an array of Project objects in the same shape as
[Get Project](/api-reference/other/projects-get), and `NextCursor` continues it. Useful for reconciling your client list
against DNCScrub and for finding Projects whose SAN is about to expire.

## Request

<ParamField header="loginId" type="string" required>
  Your API Key.
</ParamField>

<ParamField query="status" type="string" default="active">
  `active`, `inactive` or `all`.
</ParamField>

<ParamField query="limit" type="integer" default="100">
  Page size, 1 to 500.
</ParamField>

<ParamField query="cursor" type="string">
  Opaque cursor from the previous page's `NextCursor`. Omit for the first page.
</ParamField>

## Example Request

```bash cURL theme={null}
curl 'https://dataapi.dncscrub.com/v1.5/projects?limit=100' \
  --header 'loginId: YOUR_API_KEY'
```

## Response

```json 200 OK theme={null}
{
  "Data": [
    {
      "ProjectCode": "VOXAI_BRIGHTDENTAL",
      "ProjectName": "Bright Dental",
      "Status": "active",
      "DefaultCampaignId": 184201,
      "FtcValidation": { "Status": "validated", "Expiration": "2027-03-31", "...": "..." },
      "StateRegistrations": { "LA": { "Status": "approved", "...": "..." } },
      "...": "..."
    }
  ],
  "NextCursor": "eyJhZnRlciI6IlZPWEFJX0JSSUdIVERFTlRBTCJ9"
}
```

`NextCursor` is `null` on the last page. Pass it back as `cursor` to fetch the next page.
Ordering is by `projectCode`.

<Tip>
  SANs expire yearly. Watch `FtcValidation.Expiration` and prompt your client to renew
  with the FTC before that date, then call
  [Create or Update Project](/api-reference/other/projects-upsert) again with the renewed
  SAN to re-validate.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.