Get all notes for a circle

GET /api/v1/circles/{circle_uuid}/notes

Includes notes for a circle or within that circle's client's plans, cases, tasks and risks.

Path parameters

  • circle_uuid string Required

Query parameters

  • include string

    Comma separated list of relationships to include in the response. Valid relationships are [tags, mentionedAccounts].

  • filter[uuid] string

    Filter by a comma separated list of UUIDs.

  • filter[type] string

    Note type to filter by. Valid types are [call, note, meeting, email]

  • filter[date_from] string

    Note created_at date to filter from a specific date, can be used with date_to for a range.

  • filter[date_to] string

    Note created_at date to filter to from a specific date, can be used with date_from for a range.

  • filter[contents] string

    Filter notes by a string to see if it's contents contains that string.

  • filter[path] string

    Filter notes by a string to see if the path contains that string.

  • filter[path_exact] string

    Filter notes by a string to see if the path is that string.

  • filter[notable_type] string

    Filter notes by a specific notable model. Valid types are: client, plan, case, task, risk.

  • sort string

    Field to sort by. Valid fields are [created_at, updated_at, type]. Negative sign to denote DESC. Defaults to 'created_at'.

  • per_page integer

    Number of results to return with pagination (Default 15. Max 500).

Responses

  • 200 application/json
    Hide response attribute Show response attribute object
    • data array[object]
      Hide data attributes Show data attributes object
      • uuid string
      • created_at string
      • updated_at string
      • contents string
      • edited boolean
      • author_name string
      • account object
        Hide account attributes Show account attributes object
        • uuid string
        • created_at string
        • updated_at string
        • type string
        • role string
        • first_name string
        • last_name string
        • name string
        • email string
        • firm string
        • primary_phone_number string
        • primary_email string
        • current_time_entry string
        • assigned_adviser string
        • assigned_administrator string
        • assigned_paraplanner string
        • introduced_by string
        • groups string
        • tags string
        • owners string
        • first_contact_date string
        • next_review_date string
        • previous_review_date string
        • anniversary_review_date string
        • with_login boolean
        • has_joint_account boolean
        • can_be_deleted string
        • joint_account_circle string
        • ownership_percentage integer
        • inactive_at string
        • custom_fields string
        • external_references string
      • mentioned_accounts array[object]
        Hide mentioned_accounts attributes Show mentioned_accounts attributes object
        • item string
        • contents string
      • tags array[object]
        Hide tags attributes Show tags attributes object
        • uuid string
        • created_at string
        • updated_at string
        • name string
        • slug string
        • colour string
      • type string
      • notable_type string
      • notable object
        Hide notable attributes Show notable attributes object
        • uuid string
        • created_at string
        • updated_at string
        • type string
        • role string
        • first_name string
        • last_name string
        • name string
        • email string
        • firm string
        • primary_phone_number string
        • primary_email string
        • current_time_entry string
        • assigned_adviser string
        • assigned_administrator string
        • assigned_paraplanner string
        • introduced_by string
        • groups string
        • tags string
        • owners string
        • first_contact_date string
        • next_review_date string
        • previous_review_date string
        • anniversary_review_date string
        • with_login boolean
        • has_joint_account boolean
        • can_be_deleted string
        • joint_account_circle string
        • ownership_percentage integer
        • inactive_at string
        • custom_fields string
        • external_references string
      • external_references array[object]
        Hide external_references attributes Show external_references attributes object
        • uuid string
        • created_at string
        • updated_at string
        • third_party string
        • reference string
GET /api/v1/circles/{circle_uuid}/notes
curl \
 --request GET 'https://api.plannrcrm.com/api/v1/circles/6ff8f7f6-1eb3-3525-be4a-3932c805afed/notes' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "data": [
    {
      "tags": [
        {
          "name": "Mortgage",
          "slug": "mortgage",
          "uuid": "febd7252-4772-4ca5-aea0-d24147d8a9eb",
          "colour": "#ef4582",
          "created_at": "2025-06-26T11:37:02+01:00",
          "updated_at": "2025-06-26T11:37:02+01:00"
        }
      ],
      "type": "meeting",
      "uuid": "4bba3c63-7e16-48bd-ae61-0f26d76c2973",
      "edited": true,
      "account": {
        "firm": "App\\Http\\Resources\\FirmResource",
        "name": "Gareth Thompson",
        "role": "client",
        "tags": "App\\Http\\Resources\\TagResource",
        "type": "client",
        "uuid": "16ccc985-2338-4931-8400-d475c214ea19",
        "email": "gareth@codepotato.co.uk",
        "groups": "App\\Http\\Resources\\GroupResource",
        "owners": "App\\Http\\Resources\\AccountResource",
        "last_name": "Thompson",
        "created_at": "2025-06-26T11:37:02+01:00",
        "first_name": "Gareth",
        "updated_at": "2025-06-26T11:37:02+01:00",
        "with_login": true,
        "inactive_at": "2025-06-26",
        "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
        "introduced_by": "App\\Http\\Resources\\AccountResource",
        "primary_email": "App\\Http\\Resources\\ContactDetailResource",
        "can_be_deleted": "false",
        "assigned_adviser": "App\\Http\\Resources\\AccountResource",
        "next_review_date": "2025-06-26T11:37:02+01:00",
        "has_joint_account": true,
        "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
        "first_contact_date": "2025-06-26T11:37:02+01:00",
        "external_references": "App\\Http\\Resources\\ExternalReferenceResource",
        "assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
        "joint_account_circle": "App\\Http\\Resources\\CircleResource",
        "ownership_percentage": 100,
        "previous_review_date": "2025-06-26T11:37:02+01:00",
        "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
        "assigned_administrator": "App\\Http\\Resources\\AccountResource",
        "anniversary_review_date": "2025-06-26T11:37:02+01:00"
      },
      "notable": {
        "firm": "App\\Http\\Resources\\FirmResource",
        "name": "Gareth Thompson",
        "role": "client",
        "tags": "App\\Http\\Resources\\TagResource",
        "type": "client",
        "uuid": "d9c99cfe-77a6-4831-93a1-793d5df8ea7d",
        "email": "gareth@codepotato.co.uk",
        "groups": "App\\Http\\Resources\\GroupResource",
        "owners": "App\\Http\\Resources\\AccountResource",
        "last_name": "Thompson",
        "created_at": "2025-06-26T11:37:02+01:00",
        "first_name": "Gareth",
        "updated_at": "2025-06-26T11:37:02+01:00",
        "with_login": true,
        "inactive_at": "2025-06-26",
        "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
        "introduced_by": "App\\Http\\Resources\\AccountResource",
        "primary_email": "App\\Http\\Resources\\ContactDetailResource",
        "can_be_deleted": "false",
        "assigned_adviser": "App\\Http\\Resources\\AccountResource",
        "next_review_date": "2025-06-26T11:37:02+01:00",
        "has_joint_account": true,
        "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
        "first_contact_date": "2025-06-26T11:37:02+01:00",
        "external_references": "App\\Http\\Resources\\ExternalReferenceResource",
        "assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
        "joint_account_circle": "App\\Http\\Resources\\CircleResource",
        "ownership_percentage": 100,
        "previous_review_date": "2025-06-26T11:37:02+01:00",
        "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
        "assigned_administrator": "App\\Http\\Resources\\AccountResource",
        "anniversary_review_date": "2025-06-26T11:37:02+01:00"
      },
      "contents": "Great work",
      "created_at": "2025-06-26T11:37:02+01:00",
      "updated_at": "2025-06-26T11:37:02+01:00",
      "author_name": "John Smith",
      "notable_type": "client",
      "mentioned_accounts": [
        {
          "item": "Gareth Thompson",
          "contents": "<span data-type=\"mention\" data-account-uuid=\"bad94c9f-6654-4271-803b-250a071722ef\">@Gareth Thompson</span>"
        }
      ],
      "external_references": [
        {
          "uuid": "7baff0b9-8a7d-4258-9d45-3c84420a842f",
          "reference": "AB123456",
          "created_at": "2025-06-26T11:37:02+01:00",
          "updated_at": "2025-06-26T11:37:02+01:00",
          "third_party": "nucleus"
        }
      ]
    }
  ]
}