# list_hiring_projects: List Recruiter hiring projects

List your Recruiter hiring projects. This action only reads; it changes nothing. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/list_hiring_projects
Authorization: Bearer YOUR_KEY
content-type: application/json

{}
```

## What you give it

- `state` (optional): a list (one of: ACTIVE, ARCHIVED), up to 2. Which projects (default ACTIVE).
- `sortBy` (optional): one of: NAME, FAVORITE, CREATED_TIME, ACCESSED_TIME, ENGAGED_TIME, ENGAGEMENT_COUNT. Order by (default ACCESSED_TIME).
- `sortOrder` (optional): one of: ASCENDING, DESCENDING. Default DESCENDING.
- `limit` (optional): a number, 1 to 100. How many to return (1–100, default 25).
- `cursor` (optional): a cursor. nextCursor from the previous call, to get the next page. Keep the other arguments the same. Where to get it: The `nextCursor` from the last answer of `list_hiring_projects`.
- `connectionId` (optional): a connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.

## What you get back

- `returned`: number
- `nextCursor`: a cursor
- `projects[].id`: a hiring project id
- `projects[].name`: string
- `projects[].archived`: boolean
- `projects[].ownerName`: string
- `projects[].ownerId`: string
- `projects[].createdAt`: string
- `projects[].jobPosting.id`: a job id

Page: https://heyreagent.com/docs/actions/list_hiring_projects