# list_job_postings: List my job postings

List your job postings: open, drafts or closed. This action only reads; it changes nothing. Plan: Free and Connect.

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

{}
```

## What you give it

- `category` (optional): one of: active, draft, closed. Which postings (default active).
- `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_job_postings`.
- `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
- `jobPostings[].id`: a job id
- `jobPostings[].state`: active | draft | review | closed | paused
- `jobPostings[].title`: string
- `jobPostings[].description`: string
- `jobPostings[].company`: string
- `jobPostings[].companyId`: string
- `jobPostings[].location`: string
- `jobPostings[].applicantsCounter`: number
- `jobPostings[].viewsCounter`: number
- `jobPostings[].cost`: number
- `jobPostings[].createdAt`: number
- `jobPostings[].publishedAt`: number
- `jobPostings[].closedAt`: number
- `jobPostings[].applyUrl`: string
- `jobPostings[].salary`: string
- `jobPostings[].workplace`: string
- `jobPostings[].seniority`: string
- `jobPostings[].skills`: string[]
- `jobPostings[].functions`: string[]
- `jobPostings[].industries`: string[]

## Good to know

- Drafts are listed only with category "draft".

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