# get_hiring_project: Get a Recruiter hiring project

Read one Recruiter hiring project. This action only reads; it changes nothing. Plan: Free and Connect.

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

{
  "projectId": "PASTE_HIRING_PROJECT_ID_HERE"
}
```

## What you give it

- `projectId` (needed): a hiring project id. The hiring project id (from list_hiring_projects). Where to get it: Run `list_hiring_projects` and use `projects[].id`.
- `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

- `id`: a hiring project id
- `name`: string
- `archived`: boolean
- `ownerName`: string
- `ownerId`: string
- `createdAt`: string
- `jobPosting.id`: a job id
- `jobPosting.state`: active | draft | review | closed | paused
- `jobPosting.title`: string
- `jobPosting.description`: string
- `jobPosting.company`: string
- `jobPosting.companyId`: string
- `jobPosting.location`: string
- `jobPosting.applicantsCounter`: number
- `jobPosting.viewsCounter`: number
- `jobPosting.cost`: number
- `jobPosting.createdAt`: number
- `jobPosting.publishedAt`: number
- `jobPosting.closedAt`: number
- `jobPosting.applyUrl`: string
- `jobPosting.salary`: string
- `jobPosting.workplace`: string
- `jobPosting.seniority`: string
- `jobPosting.skills`: string[]
- `jobPosting.functions`: string[]
- `jobPosting.industries`: string[]

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