Notes

List notes by candidate

Returns paginated discussion notes for a candidate. Use for shared recruiter context and timeline synchronization.

get/notes

Request

  • Base URL: https://api.100hires.com/v2
  • URL: https://api.100hires.com/v2/notes
  • Auth: HTTP bearer

Query parameters

candidate_idstring required

Candidate ID (numeric) or alias

includestring

Comma-separated list of related resources to include. Supported: user — author details, candidate — full candidate payload with url_backoffice for UI deep-linking.

pageinteger

Page number (1-based). Defaults to 1.

sizeinteger

Number of items per page (1–100). Defaults to 20.

view'full' | 'summary'

Response shape selector for list endpoints. full (default) returns every field — backward-compatible with pre-existing clients. summary returns a thinned payload designed for agent-friendly list browsing: heavy fields (description HTML, embedded profile answers, full message bodies, embedded relations, etc.) are omitted or replaced with *_preview truncations. Use summary when paging through large result sets and fetch a single record with the corresponding GET /{resource}/{id} endpoint when full data is needed.

Response

Note list

Example response

{
  "notes": [
    {
      "url_backoffice": "https://app.100hires.com/candidate/dtGeby2#/profile/discussion",
      "candidate": {
        "alias": "dtGeby2",
        "url_backoffice": "https://app.100hires.com/candidate/dtGeby2"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.