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

# List Candidate Projects

Retrieve a list of candidate projects.

Required Scope: `candidatesRead`

**Note:** Private candidate field data is unavailable by default. For more information please refer to [Ashby documentation](https://developers.ashbyhq.com/reference/authentication#private-fields-access).

<Note>
  External Documentation

  To learn more, visit the [Ashby documentation](https://developers.ashbyhq.com/reference/candidatelistprojects).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                              |
  | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
  | Candidate ID     | The ID of the candidate to retrieve projects for.                                                                                        |
  | Cursor           | The cursor used to paginate through the results. Use the value returned in `nextCursor` from a prior response to retrieve the next page. |
  | Limit            | The maximum number of candidate projects to return. Valid range is `1`-`100`.                                                            |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                                         |
  | Sync Token       | A token representing the last time the data was successfully synced.                                                                     |
</div>

## Example Output

```json theme={"dark"}
{
	"success": true,
	"moreDataAvailable": true,
	"nextCursor": "G8",
	"results": [
		{
			"id": "e9ed20fd-d45f-4aad-8a00-a19bfba0083e",
			"title": "Office Event",
			"description": "Folks invited to office for an event",
			"isArchived": false,
			"confidential": false,
			"authorId": "e9ed20fd-d45f-4aad-8a00-a19bfba0083e",
			"createdAt": "2022-08-12T20:29:56.964Z",
			"customFieldEntries": [
				{
					"id": "e9ed20fd-d45f-4aad-8a00-a19bfba0083e",
					"isPrivate": false,
					"title": "string",
					"valueLabel": "string",
					"value": true
				}
			]
		}
	]
}
```

## Workflow Library Example

[List Candidate Projects with Ashby and Send Results Via Email](https://library.blinkops.com/workflows/list-candidate-projects-with-ashby-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-candidate-projects-with-ashby-and-send-results-via-email/canvas" />
</div>