GET /api/v2/risks

This endpoint will return all risks in the firm relevant to the user accessing them.

Headers

  • X-PLANNR-ACCOUNT-UUID string

Query parameters

  • filter[uuid] string

    Filter by a comma separated list of UUIDs.

  • filter[level] integer

    Filter by the numeric level value. Whole number between 1 and 1,000.

  • filter[level_string] string

    Filter by the string/text version of risk level of the client.

  • filter[completed_after] string

    Date (with optional time) to filter when the record was created after.

  • filter[completed_before] string

    Date (with optional time) to filter when the record was created before.

  • filter[risk_assessment_provider] string

    Filter by the name of provider for the risk assessment.

  • filter[time_horizon_set_after] string

    Date (with optional time) to filter when the record was created after.

  • filter[time_horizon_set_before] string

    Date (with optional time) to filter when the record was created before.

  • filter[account_uuids] string

    Filter by a comma separated list of account UUIDs.

  • filter[circle_uuids] string

    Filter by a comma separated list of circle UUIDs.

  • include string

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

  • sort string

    Field to sort by. Valid fields are [created_at, updated_at, level, level_string, completed_at, risk_assessment_provider, time_horizon_set_at]. 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

        The UUID of the resource.

      • created_at string

        The timestamp of when the resource was created.

      • updated_at string

        The timestamp of when the resource was updated.

      • level integer

        The risk level of the clients risk assessment. Cannot be set with level_string

      • level_string string

        The risk level of the client as a string/text. Cannot be set with level.

      • completed_at string

        Date of risk assessment completion.

      • completed_by object

        Account of the employee that completed the risk assessment

        Hide completed_by attributes Show completed_by attributes object
        • uuid string
        • created_at string
        • updated_at string
        • type string
        • role string
        • first_name string
        • last_name string
        • name string
        • email string
        • photo_url 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
        • circles string
        • ownership_percentage integer
        • inactive_at string
        • last_interaction_at string
        • custom_fields string
        • external_references string
      • risk_assessment_provider string

        Name of the risk assessment provider.

      • time_horizon string

        How long the risk assessment will last for the client.

      • time_horizon_set_at string

        The date the time_horizon was set. Can be used as a reference point against time horizon for users.

      • account object

        The account who owns the Risk. This may not be included when viewing all risks. Refer to the documentation to include this field.

        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
        • photo_url string
        • external_references string
GET /api/v2/risks
curl \
 --request GET 'https://api.plannrcrm.com/api/v2/risks' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}"
Response examples (200)
{
  "data": [
    {
      "uuid": "83fe18e1-4638-42f5-b2dd-f097e2dcdd12",
      "level": 52,
      "account": {
        "name": "Gareth Thompson",
        "role": "client",
        "type": "client",
        "uuid": "3c16e1cf-a1d3-46de-bb1c-657f48354989",
        "email": "gareth@codepotato.co.uk",
        "last_name": "Thompson",
        "photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
        "created_at": "2025-12-24T11:03:00+00:00",
        "first_name": "Gareth",
        "updated_at": "2025-12-24T11:03:00+00:00",
        "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
      },
      "created_at": "2025-12-24T11:03:00+00:00",
      "updated_at": "2025-12-24T11:03:00+00:00",
      "completed_at": "2024-12-24T11:03:00+00:00",
      "completed_by": {
        "firm": "App\\Http\\Resources\\FirmResource",
        "name": "Gareth Thompson",
        "role": "client",
        "tags": "App\\Http\\Resources\\TagResource",
        "type": "client",
        "uuid": "4051e2f4-a3f0-461d-b6bc-b7394e6661f4",
        "email": "gareth@codepotato.co.uk",
        "groups": "App\\Http\\Resources\\GroupResource",
        "owners": "App\\Http\\Resources\\AccountResource",
        "circles": "App\\Http\\Resources\\CircleResource",
        "last_name": "Thompson",
        "photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
        "created_at": "2025-12-24T11:03:00+00:00",
        "first_name": "Gareth",
        "updated_at": "2025-12-24T11:03:00+00:00",
        "with_login": true,
        "inactive_at": "2025-12-24",
        "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-12-24T11:03:00+00:00",
        "has_joint_account": true,
        "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
        "first_contact_date": "2025-12-24T11:03:00+00:00",
        "external_references": "App\\Http\\Resources\\ExternalReferenceResource",
        "last_interaction_at": "2025-12-24 11:03:00",
        "assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
        "joint_account_circle": "App\\Http\\Resources\\CircleResource",
        "ownership_percentage": 100,
        "previous_review_date": "2025-12-24T11:03:00+00:00",
        "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
        "assigned_administrator": "App\\Http\\Resources\\AccountResource",
        "anniversary_review_date": "2025-12-24T11:03:00+00:00"
      },
      "level_string": "Moderately Aggressive",
      "time_horizon": "For the next 5 years",
      "time_horizon_set_at": "2025-11-24T11:03:00+00:00",
      "risk_assessment_provider": "Defaqto"
    }
  ]
}