[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# List candidate notes

> The notes on a candidate record, newest first. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/jobdiva/list_candidate_notes

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

The notes on a candidate record, newest first.

JobDiva API: https://cotlet.dev/docs/api/jobdiva.md

`GET https://cotlet.dev/api/v1/jobdiva/candidate-notes`

Access: read.

Returns each note with its text, action type, action date and author, and the job it is linked to when it has one. Pinned notes are marked. Read it before add_candidate_note to avoid a double note.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `candidate_id` | integer | yes | Candidate ID from search_candidates or find_candidate. |

## Request

**cURL**

```bash
curl "https://cotlet.dev/api/v1/jobdiva/candidate-notes?candidate_id=1" \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("jobdiva", "list_candidate_notes", {"candidate_id":1})
```

**Node.js**

```js
const result = await cotlet.call('jobdiva', 'list_candidate_notes', {"candidate_id":1});
```

**CLI**

```bash
cotlet call jobdiva list_candidate_notes --data '{"candidate_id":1}'
```

## Example response

```json
{
  "notes": [
    {
      "note_id": 90214477,
      "action": "Phone Call",
      "date": "2026-10-19",
      "author": "Jonas Weber",
      "note": "Left a voicemail about the Northwind role.",
      "pinned": false,
      "job_id": 24071835
    }
  ]
}
```

Previous: [Get candidate](https://cotlet.dev/docs/api/jobdiva/get_candidate.md)
Next: [Search jobs](https://cotlet.dev/docs/api/jobdiva/search_jobs.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.