PUT /api/v1/client/{uuid}
Personal access token & O auth2

Headers

  • X-PLANNR-ACCOUNT-UUID string

Path parameters

  • uuid string Required
application/json

Body

  • title string

    Title

  • first_name string

    First name

  • middle_name string

    Middle name.

  • last_name string

    Last name

  • maiden_name string

    Maiden name.

  • entity_name string

    Entity name for shared account types

  • assigned_adviser_uuid string(uuid)

    The UUID of the employee that the client directly reports to

  • assigned_administrator_uuid string(uuid)

    The UUID of the adviser employee that the client has been assigned

  • assigned_paraplanner_uuid string(uuid)

    The UUID of the paraplanner employee that the client has been assigned

  • introduced_by_uuid string(uuid)

    The UUID of the introducer for this client

  • date_of_birth string(date)

    Date of birth

  • gender string

    Gender. Possible values are: male, female, non-binary, transgender, intersex, other and unknown

    Value Description
    male male
    female female
    non-binary non-binary
    transgender transgender
    intersex intersex
    other other
    unknown unknown

    Values are male, female, non-binary, transgender, intersex, other, or unknown.

  • ni_number string

    National Insurance Number

  • nickname string

    preferred nickname of the client

  • target_retirement_age integer

    Target retirement age.

  • pronouns string

    Pronouns

  • smoker_status string

    Smoker Status. Possible values are: smoker, non-smoker, vaper, ex-smoker, never-smoked, unknown

    Value Description
    smoker Smoker
    non-smoker Non Smoker
    vaper Vaper
    ex-smoker Ex Smoker
    never-smoked Never Smoked
    unknown Unknown

    Values are smoker, non-smoker, vaper, ex-smoker, never-smoked, or unknown.

  • residential_status string

    Residential status

    Value Description
    homeowner Homeowner
    renting Renting
    living_with_parents Living With Parents
    other Other

    Values are homeowner, renting, living_with_parents, or other.

  • country_of_residence string

    Country of residence

  • marital_status string

    Marital status. Possible values are: single, cohabiting, married, divorced, civil-partnership, dissolved-civil-partnership, widowed, separated, engaged, in-relationship, other, unknown

    Value Description
    single single
    cohabiting cohabiting
    married married
    divorced divorced
    civil-partnership civil partnership
    dissolved-civil-partnership dissolved-civil-partnership
    widowed widowed
    separated separated
    engaged engaged
    in-relationship in a relationship
    other other
    unknown unknown

    Values are single, cohabiting, married, divorced, civil-partnership, dissolved-civil-partnership, widowed, separated, engaged, in-relationship, other, or unknown.

  • is_vulnerable string

    whether the client is vulnerable. Possible values are: "yes", "no", and "possibly"

    Values are yes, no, or possibly.

  • is_prospect boolean

    Denotes if the client is a prospect or not.

  • prospect_converted_at string(date)

    The datetime when the prospect was converted into a client.

  • value integer

    The value of the client in penny format. E.g £5,000 would be 500000.

  • is_uk_resident boolean

    Whether the client is a UK resident or not.

  • is_uk_domicile boolean

    Whether the client is a UK domicile or not.

  • expected_retirement_age integer

    The expected retirement age.

  • state_retirement_age integer

    The state retirement age.

  • nationalities array

    Nationalities of the client. You can use the api/v1/static/nationalities endpoint to get our list.

  • vulnerability_details string

    Any details regarding the client's vulnerabilities.

  • vulnerability_sub_type array[string]

    One or more vulnerability sub types.

    Values are health, life_events, resilience, or capability.

  • vulnerability_last_assessment_date string(date) | null

    The date of the last vulnerability assessment.

  • vulnerability_duration string

    Whether the vulnerability is temporary or permanent.

    Value Description
    temporary Temporary
    permanent Permanent

    Values are temporary or permanent.

  • third_party_offered boolean

    Whether the client has been offered any third party.

  • procedure_adaptation boolean

    Whether any procedures need to be adapted to the client.

  • adaption_details_notes boolean

    Any notes regarding adaptations

  • client_preferences string

    Any client preferences.

  • current_state_of_health string

    The client's current state of health.

  • state_of_health_explanation string

    Explanation of the current state of health.

  • cigarettes_daily integer

    The amount of cigarettes the client smokes a day.

  • smoker_since string(date)

    The date of when the client started smoking.

  • long_term_care_needed boolean

    Whether the client required long term care.

  • long_term_care_notes string

    Notes on the client's long term care.

  • has_will boolean

    Whether the client has a will or not.

  • will_notes string

    Notes on the client's will.

  • will_last_reviewed string(date)

    The date of the last time the will's been reviewed.

  • has_power_of_attorney boolean

    Whether the client has power of attorney.

  • power_of_attorney_notes string

    Notes on the client's power of attorney.

  • first_contact_date string(date)

    The date of the first contact.

  • units_of_alcohol_weekly integer

    The units of alcohol digested weekly.

  • height integer

    The height of the client in centimeters.

  • weight integer

    The weight of the client in pounds.

  • health_notes string

    Notes on the client's health.

  • has_iht_planning boolean

    Whether the client has Inheritance Tax (IHT) planning or not.

  • iht_planning_notes string

    Notes on the client's Inheritance Tax (IHT) planning.

  • has_gifted_family boolean

    Whether the client has gifted the family.

  • gift_notes string

    Notes on the gifts.

  • is_anticipating_inheritance boolean

    Whether the client is anticipating/ expecting any inheritance.

  • anticipating_inheritance_notes string

    Notes on the client's inheritance anticipation/ expectations.

  • next_review_date string(date)

    Date of next review

  • previous_review_date string(date)

    Date of previous review

  • anniversary_review_date string(date)

    Anniversary review date

  • is_will_accurate boolean

    Does your current will reflect your wishes?

  • will_executors string

    Who are the executors?

  • will_location string

    Where is the will stored?

  • will_bequests_detail string

    Details of any Bequests

  • is_poa_registered_epa_or_lpa string

    Is the Power of Attorney Registered as a EPA or LPA

    Value Description
    epa Epa
    lpa Lpa

    Values are epa or lpa.

  • are_poa_appointed_for_health_or_wealth string

    Are the Attorneys appointed for Health, Wealth or Both?

    Values are health, wealth, or both.

  • poa_attorney_appointed_at string(date)

    When were the Attorney’s appointed?

  • will_poa_details string

    Who are the Attorney’s?

  • are_poa_documents_registered boolean

    Are the documents registered?

  • will_gifts_details string

    Notes of gifts

  • is_in_receipt_of_your_state_pension boolean

    Are you in receipt of your State Pension

  • has_obtained_a_forecast boolean

    Have you recently obtained a forecast

  • date_of_forecast string(date)

    What is the date of the obtained forecast

  • projected_state_pension integer

    What is the projected State Pension

  • years_of_national_insurance_contributions integer

    How many years have you made Nation Insurance Contributions

  • pension_notes string

    Notes on the pension

  • date_of_marriage string(date)

    Date of marriage

  • is_deceased boolean

    Denotes if the client is deceased

  • deceased_at string(date)

    Date of death

  • is_married_to_partner boolean

    Denotes if the client is married to their partner

  • checked_sanctions_at string(date)

    Date the client was checked for sanctions

  • lead_source string

    Marks the lead source of the client

  • write_to_whom string

    Marks the name of the client to write to

  • passport_number string

    The passport number of the client

  • do_not_contact_via_fax boolean

    Denotes if the client can be contacted via fax

  • do_not_contact_via_mail boolean

    Denotes if the client can be contacted via mail

  • do_not_contact_via_sms boolean

    Denotes if the client can be contacted via SMS

  • do_not_contact_via_email boolean

    Denotes if the client can be contacted via email

  • do_not_contact_via_telephone boolean

    Denotes if the client can be contacted via telephone

  • do_not_visit boolean

    Denotes if the client can be visited

  • do_not_market boolean

    Denotes if the client can be visited

  • status_uuid string(uuid)

    The status of the client.

  • groups array[string(uuid)]

    Group UUIDs to sync client to. Null can be provided to clear a clients groups.

  • client_regulatory_classification string

    The regulatory classification of the client. Possible values are: retail_client, professional_client, eligible_counterparty, not_applicable and unknown

Responses

  • 200 application/json
    Hide response attributes Show response 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.

    • type string

      Account type

    • role string

      Account role

    • first_name string

      First name

    • last_name string

      Last name

    • name string

      Name

    • email string

      (Deprecated - Please use primary_email instead). The email of the account.

    • photo_url string

      URL for initial avatar image

    • firm object

      Firm

      Hide firm attributes Show firm attributes object
      • uuid string
      • created_at string
      • updated_at string
      • name string
      • slug string
      • address_1 string
      • address_2 string
      • town_city string
      • county string
      • postcode string
      • country string
      • regulatory_text string
      • logo_icon string
      • brand_colours object
        Hide brand_colours attributes Show brand_colours attributes object
        • sidebar_background string
        • sidebar_accent string
        • sidebar_text string
        • sidebar_hover string
        • sidebar_active string
        • sidebar_title_background string
        • sidebar_title_primary string
        • sidebar_title_secondary string
        • sidebar_title_secondary_hover string
        • email_background string
        • email_logo_background_panel string
        • email_sub_text string
        • email_button_background string
        • email_button_text string
        • portal_sidebar_button_background string
        • portal_sidebar_button_hover string
        • portal_sidebar_button_active string
        • portal_brand_title string
        • portal_brand_sub_title string
        • portal_sidebar_title string
        • portal_sidebar_text string
        • portal_sidebar_text_hover string
        • portal_sidebar_text_active string
        • portal_sidebar_icon string
        • portal_sidebar_icon_hover string
        • portal_sidebar_icon_active string
        • portal_background string
        • portal_sidebar_account_title string
        • portal_sidebar_account_email string
        • portal_sidebar_divider string
        • portal_dashboard_bg_one string
        • portal_dashboard_bg_two string
        • portal_sidebar_collapse_button string
        • portal_sidebar_collapse_button_hover string
        • portal_sidebar_user_select_background string
        • portal_sidebar_user_select_hover string
        • portal_sidebar_user_select_text string
        • portal_sidebar_user_select_text_hover string
        • portal_sidebar_user_select_border string
        • portal_sidebar_user_select_border_hover string
      • is_subscribed boolean
      • addon_subscriptions string
      • keep_deleted_files_for integer
      • tax number
      • month_end integer
      • statement_frequency string
      • billing object
        Hide billing attributes Show billing attributes object
        • invoice_address_1 string
        • invoice_address_2 string
        • invoice_town_city string
        • invoice_county string
        • invoice_postcode string
        • invoice_country string
        • invoice_email string
      • task_board_template string
      • ip_whitelist array[string]
      • welcome_paragraph_html string
      • email_welcome_paragraph_html string
      • show_fact_find_illustrations boolean
      • cc_email_addresses array[string]
      • bcc_email_addresses array[string]
      • reply_to_email_address string
      • mobile_app_support_number string
      • mobile_app_support_email string
    • primary_phone_number object

      Primary phone number

      Hide primary_phone_number attributes Show primary_phone_number attributes object
      • uuid string
      • created_at string
      • updated_at string
      • type string
      • name string
      • value string
      • phone_number_meta object
        Hide phone_number_meta attributes Show phone_number_meta attributes object
        • country string
        • formatted string
      • accounts string
    • primary_email object

      Primary email

      Hide primary_email attributes Show primary_email attributes object
      • uuid string
      • created_at string
      • updated_at string
      • type string
      • name string
      • value string
      • phone_number_meta object
        Hide phone_number_meta attributes Show phone_number_meta attributes object
        • country string
        • formatted string
      • accounts string
    • current_time_entry object

      Current time entry

      Hide current_time_entry attributes Show current_time_entry attributes object
      • uuid string
      • created_at string
      • updated_at string
      • name string
      • description string
      • trackable_type string
      • trackable string
      • start_date string
      • end_date string
      • is_active boolean
      • total_time_in_minutes integer
      • computed_time_elapsed_in_seconds integer
      • account string
    • assigned_adviser object

      Assigned adviser

      Hide assigned_adviser attributes Show assigned_adviser 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
      • business_unit 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
      • referral_code string
      • permissions object
        Hide permissions attributes Show permissions attributes object
        • firm:read array[string]
        • network:read array[string]
      • custom_fields string
      • external_references string
    • assigned_administrator object

      Assigned administrator

      Hide assigned_administrator attributes Show assigned_administrator 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
      • business_unit 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
      • referral_code string
      • permissions object
        Hide permissions attributes Show permissions attributes object
        • firm:read array[string]
        • network:read array[string]
      • custom_fields string
      • external_references string
    • assigned_paraplanner object

      Assigned paraplanner

      Hide assigned_paraplanner attributes Show assigned_paraplanner 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
      • business_unit 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
      • referral_code string
      • permissions object
        Hide permissions attributes Show permissions attributes object
        • firm:read array[string]
        • network:read array[string]
      • custom_fields string
      • external_references string
    • introduced_by object

      Introduced by

      Hide introduced_by attributes Show introduced_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
      • business_unit 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
      • referral_code string
      • permissions object
        Hide permissions attributes Show permissions attributes object
        • firm:read array[string]
        • network:read array[string]
      • custom_fields string
      • external_references string
    • business_unit object

      The business unit this account belongs to

      Hide business_unit attributes Show business_unit attributes object
      • uuid string
      • name string
      • has_alternative_branding boolean
      • brand_colours array
      • members_count integer
      • members string
      • groups_count integer
      • groups string
      • firm string
      • created_at string
      • updated_at string
    • groups array[object]

      Groups

      Hide groups attributes Show groups attributes object
      • uuid string
      • name string
      • slug string
      • participants_count string
      • participants object
        Hide participants attributes Show participants attributes object
        • uuid object
          Hide uuid attributes Show uuid attributes object
          • example string
          • description string
        • role object
          Hide role attributes Show role attributes object
          • example string
          • description string
        • first_name object
          Hide first_name attributes Show first_name attributes object
          • example string
          • description string
        • last_name object
          Hide last_name attributes Show last_name attributes object
          • example string
          • description string
        • name object
          Hide name attributes Show name attributes object
          • example string
          • description string
        • email object
          Hide email attributes Show email attributes object
          • example string
          • description string
      • created_at string
      • updated_at string
    • tags array[object]

      Tags

      Hide tags attributes Show tags attributes object
      • uuid string
      • created_at string
      • updated_at string
      • name string
      • slug string
      • colour string
    • owners array[object]

      Accounts that own this account

      Hide owners attributes Show owners 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
      • business_unit 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
      • referral_code string
      • permissions object
        Hide permissions attributes Show permissions attributes object
        • firm:read array[string]
        • network:read array[string]
      • custom_fields string
      • external_references string
    • first_contact_date string

      First contact date

    • next_review_date string

      Next review date

    • previous_review_date string

      Previous review date

    • anniversary_review_date string

      Anniversary review date

    • with_login boolean

      Denotes whether the account has a login to Plannr

    • has_joint_account boolean

      Denotes whether this account belongs to a joint account too

    • can_be_deleted string

      Denotes if the account can be deleted

    • joint_account_circle object

      This field is only present when viewing a joint account directly. This will contain the circle that we automatically created when we released circles.

      Hide joint_account_circle attributes Show joint_account_circle attributes object
      • uuid string
      • created_at string
      • updated_at string
      • name string
      • photo_url string
      • bg_colour string
      • accounts string
      • groups string
      • joint_account_uuid string
      • login_access_level string
      • external_references string
    • circles array[object]

      The circles the account belongs to

      Hide circles attributes Show circles attributes object
      • uuid string
      • created_at string
      • updated_at string
      • name string
      • photo_url string
      • bg_colour string
      • accounts string
      • groups string
      • joint_account_uuid string
      • login_access_level string
      • external_references string
    • ownership_percentage integer

      Percentage ownership of the plan (This field is only present if viewing the account record via a plans relationship eg Plan -> Accounts)

    • inactive_at string

      Inactive from date

    • last_interaction_at string

      Last interaction date

    • referral_code string

      Unique referral code for the employee account (employees only)

    • permissions object

      Permission map where keys are permission names and values are target arrays

      Hide permissions attributes Show permissions attributes object
      • firm:read array[string]
      • network:read array[string]
    • custom_fields array[object]

      Any custom fields on the model.

      Hide custom_fields attributes Show custom_fields attributes object
      • uuid string
      • created_at string
      • updated_at string
      • type string
      • name string
      • reference string
      • is_required boolean
      • value string
      • selection_options array[string]
      • help_text string
    • external_references array[object]

      The external references that have been added to the client.

      Hide external_references attributes Show external_references attributes object
      • uuid string
      • created_at string
      • updated_at string
      • third_party string
      • reference string
PUT /api/v1/client/{uuid} 
curl \
 --request PUT 'https://api.plannrcrm.com/api/v1/client/6ff8f7f6-1eb3-3525-be4a-3932c805afed' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"title":"Mr","first_name":"Gareth","middle_name":"Alex","last_name":"Thompson","maiden_name":"Thompson","entity_name":"Plannr Ltd","assigned_adviser_uuid":"489f4bc0-b73a-461d-ae75-6bd5d8dd4740","assigned_administrator_uuid":"40d907d2-11fe-47de-a229-12439e6d380e","assigned_paraplanner_uuid":"aa77cfb2-1e8e-41ae-b7a6-c19eeb471cd7","introduced_by_uuid":"cf3b8a2d-d009-4d38-a72c-e16be47bad7a","date_of_birth":"1976-04-29","gender":"male","ni_number":"AB 12 34 56 C","nickname":"Garth","target_retirement_age":60,"pronouns":"he/him","smoker_status":"smoker","residential_status":"homeowner","country_of_residence":"United Kingdom","marital_status":"single","is_vulnerable":"yes","is_prospect":false,"prospect_converted_at":"2026-04-29T12:52:59+01:00","value":500000,"is_uk_resident":true,"is_uk_domicile":true,"expected_retirement_age":60,"state_retirement_age":60,"nationalities":["British","Romanian"],"vulnerability_details":"No vulnerabilities","vulnerability_sub_type":["health"],"vulnerability_last_assessment_date":"2026-01-29","vulnerability_duration":"temporary","third_party_offered":true,"procedure_adaptation":false,"adaption_details_notes":true,"client_preferences":"Prefers telephone calls in the morning.","current_state_of_health":"Fit and healthy","state_of_health_explanation":"Explanation of the current state of health.","cigarettes_daily":6,"smoker_since":"2016-04-29","long_term_care_needed":false,"long_term_care_notes":"Notes on the client's long term care.","has_will":true,"will_notes":"Notes on the client's will.","will_last_reviewed":"2026-04-29","has_power_of_attorney":true,"power_of_attorney_notes":"Notes on the client's power of attorney.","first_contact_date":"2026-03-29","units_of_alcohol_weekly":28,"height":186,"weight":220,"health_notes":"Notes on the client's health.","has_iht_planning":true,"iht_planning_notes":"Notes on the client's Inheritance Tax (IHT) planning.","has_gifted_family":true,"gift_notes":"Notes on the gifts.","is_anticipating_inheritance":true,"anticipating_inheritance_notes":"Notes on the client's inheritance anticipation/ expectations.","next_review_date":"2026-05-29","previous_review_date":"2026-03-29","anniversary_review_date":"2026-04-29","is_will_accurate":true,"will_executors":"string","will_location":"string","will_bequests_detail":"string","is_poa_registered_epa_or_lpa":"epa","are_poa_appointed_for_health_or_wealth":"health","poa_attorney_appointed_at":"2026-04-29","will_poa_details":"string","are_poa_documents_registered":true,"will_gifts_details":"string","is_in_receipt_of_your_state_pension":true,"has_obtained_a_forecast":true,"date_of_forecast":"2026-04-29","projected_state_pension":50000,"years_of_national_insurance_contributions":5,"pension_notes":"string","date_of_marriage":"2026-04-29","is_deceased":false,"deceased_at":"2026-04-29","is_married_to_partner":true,"checked_sanctions_at":"2026-04-29","lead_source":"LeadGen Company","write_to_whom":"Gareth","passport_number":"123456","do_not_contact_via_fax":false,"do_not_contact_via_mail":false,"do_not_contact_via_sms":false,"do_not_contact_via_email":false,"do_not_contact_via_telephone":false,"do_not_visit":false,"do_not_market":false,"status_uuid":"291d64d3-a788-4fa1-bc4e-e31f3b49d565","groups":["bc837675-420f-4b13-a8b5-02a2871de15a","89b6056c-3740-4299-b5a4-3b5d2d929b28","3595bc6f-3281-4b60-9ed0-277b218c7c1b"],"client_regulatory_classification":"professional_client"}'
Request examples 
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "title": "Mr",
  "first_name": "Gareth",
  "middle_name": "Alex",
  "last_name": "Thompson",
  "maiden_name": "Thompson",
  "entity_name": "Plannr Ltd",
  "assigned_adviser_uuid": "489f4bc0-b73a-461d-ae75-6bd5d8dd4740",
  "assigned_administrator_uuid": "40d907d2-11fe-47de-a229-12439e6d380e",
  "assigned_paraplanner_uuid": "aa77cfb2-1e8e-41ae-b7a6-c19eeb471cd7",
  "introduced_by_uuid": "cf3b8a2d-d009-4d38-a72c-e16be47bad7a",
  "date_of_birth": "1976-04-29",
  "gender": "male",
  "ni_number": "AB 12 34 56 C",
  "nickname": "Garth",
  "target_retirement_age": 60,
  "pronouns": "he/him",
  "smoker_status": "smoker",
  "residential_status": "homeowner",
  "country_of_residence": "United Kingdom",
  "marital_status": "single",
  "is_vulnerable": "yes",
  "is_prospect": false,
  "prospect_converted_at": "2026-04-29T12:52:59+01:00",
  "value": 500000,
  "is_uk_resident": true,
  "is_uk_domicile": true,
  "expected_retirement_age": 60,
  "state_retirement_age": 60,
  "nationalities": [
    "British",
    "Romanian"
  ],
  "vulnerability_details": "No vulnerabilities",
  "vulnerability_sub_type": [
    "health"
  ],
  "vulnerability_last_assessment_date": "2026-01-29",
  "vulnerability_duration": "temporary",
  "third_party_offered": true,
  "procedure_adaptation": false,
  "adaption_details_notes": true,
  "client_preferences": "Prefers telephone calls in the morning.",
  "current_state_of_health": "Fit and healthy",
  "state_of_health_explanation": "Explanation of the current state of health.",
  "cigarettes_daily": 6,
  "smoker_since": "2016-04-29",
  "long_term_care_needed": false,
  "long_term_care_notes": "Notes on the client's long term care.",
  "has_will": true,
  "will_notes": "Notes on the client's will.",
  "will_last_reviewed": "2026-04-29",
  "has_power_of_attorney": true,
  "power_of_attorney_notes": "Notes on the client's power of attorney.",
  "first_contact_date": "2026-03-29",
  "units_of_alcohol_weekly": 28,
  "height": 186,
  "weight": 220,
  "health_notes": "Notes on the client's health.",
  "has_iht_planning": true,
  "iht_planning_notes": "Notes on the client's Inheritance Tax (IHT) planning.",
  "has_gifted_family": true,
  "gift_notes": "Notes on the gifts.",
  "is_anticipating_inheritance": true,
  "anticipating_inheritance_notes": "Notes on the client's inheritance anticipation/ expectations.",
  "next_review_date": "2026-05-29",
  "previous_review_date": "2026-03-29",
  "anniversary_review_date": "2026-04-29",
  "is_will_accurate": true,
  "will_executors": "string",
  "will_location": "string",
  "will_bequests_detail": "string",
  "is_poa_registered_epa_or_lpa": "epa",
  "are_poa_appointed_for_health_or_wealth": "health",
  "poa_attorney_appointed_at": "2026-04-29",
  "will_poa_details": "string",
  "are_poa_documents_registered": true,
  "will_gifts_details": "string",
  "is_in_receipt_of_your_state_pension": true,
  "has_obtained_a_forecast": true,
  "date_of_forecast": "2026-04-29",
  "projected_state_pension": 50000,
  "years_of_national_insurance_contributions": 5,
  "pension_notes": "string",
  "date_of_marriage": "2026-04-29",
  "is_deceased": false,
  "deceased_at": "2026-04-29",
  "is_married_to_partner": true,
  "checked_sanctions_at": "2026-04-29",
  "lead_source": "LeadGen Company",
  "write_to_whom": "Gareth",
  "passport_number": "123456",
  "do_not_contact_via_fax": false,
  "do_not_contact_via_mail": false,
  "do_not_contact_via_sms": false,
  "do_not_contact_via_email": false,
  "do_not_contact_via_telephone": false,
  "do_not_visit": false,
  "do_not_market": false,
  "status_uuid": "291d64d3-a788-4fa1-bc4e-e31f3b49d565",
  "groups": [
    "bc837675-420f-4b13-a8b5-02a2871de15a",
    "89b6056c-3740-4299-b5a4-3b5d2d929b28",
    "3595bc6f-3281-4b60-9ed0-277b218c7c1b"
  ],
  "client_regulatory_classification": "professional_client"
}
Response examples (200) 
{
  "uuid": "e8a03d88-0720-430c-84c4-f7f33a9dbc3c",
  "created_at": "2026-04-29T12:52:59+01:00",
  "updated_at": "2026-04-29T12:52:59+01:00",
  "type": "client",
  "role": "client",
  "first_name": "Gareth",
  "last_name": "Thompson",
  "name": "Gareth Thompson",
  "email": "gareth@codepotato.co.uk",
  "photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
  "firm": {
    "uuid": "f496df10-1194-4462-83db-234272b61643",
    "created_at": "2026-04-29T12:52:59+01:00",
    "updated_at": "2026-04-29T12:52:59+01:00",
    "name": "Codepotato",
    "slug": "codepotato",
    "address_1": "Suite E, 5 The Briars",
    "address_2": "Waterberry Drive",
    "town_city": "Waterlooville",
    "county": "Hampshire",
    "postcode": "PO7 7YH",
    "country": "United Kingdom",
    "regulatory_text": "Regulatory text",
    "logo": "https://api.plannrcrm.com/images/plannr.jpg",
    "logo_icon": "https://api.plannrcrm.com/images/plannr-icon.jpg",
    "brand_colours": {
      "sidebar_background": "#0E0E56",
      "sidebar_accent": "#36367E",
      "sidebar_text": "#FFFFFF",
      "sidebar_hover": "#0A0A42",
      "sidebar_active": "#53DBB8",
      "sidebar_title_background": "#36367E",
      "sidebar_title_primary": "#FFC634",
      "sidebar_title_secondary": "#FFFFFF",
      "sidebar_title_secondary_hover": "#FFFFFF",
      "email_background": "#0E0E56",
      "email_logo_background_panel": "#36367E",
      "email_sub_text": "#FFFFFF",
      "email_button_background": "#36367E",
      "email_button_text": "#FFFFFF",
      "portal_sidebar_button_background": "#F6F6F6",
      "portal_sidebar_button_hover": "#FFFFFF",
      "portal_sidebar_button_active": "#FFFFFF",
      "portal_brand_title": "#323B4B",
      "portal_brand_sub_title": "#828994",
      "portal_sidebar_title": "#11151D",
      "portal_sidebar_text": "#323B4B",
      "portal_sidebar_text_hover": "#323B4B",
      "portal_sidebar_text_active": "#323B4B",
      "portal_sidebar_icon": "#828994",
      "portal_sidebar_icon_hover": "#828994",
      "portal_sidebar_icon_active": "#828994",
      "portal_background": "#F6F6F6",
      "portal_sidebar_account_title": "#11151D",
      "portal_sidebar_account_email": "#828994",
      "portal_sidebar_divider": "#E3E5E9",
      "portal_dashboard_bg_one": "#EF4583",
      "portal_dashboard_bg_two": "#FFC634",
      "portal_sidebar_collapse_button": "#828994",
      "portal_sidebar_collapse_button_hover": "#B3B9C4",
      "portal_sidebar_user_select_background": "#F6F6F6",
      "portal_sidebar_user_select_hover": "#F6F6F6",
      "portal_sidebar_user_select_text": "#323B4B",
      "portal_sidebar_user_select_text_hover": "#323B4B",
      "portal_sidebar_user_select_border": "#EEEEEE",
      "portal_sidebar_user_select_border_hover": "#828994"
    },
    "is_subscribed": true,
    "addon_subscriptions": "App\\Http\\Resources\\Addons\\AddonSubscriptionResource",
    "keep_deleted_files_for": 30,
    "tax": 17.5,
    "month_end": 25,
    "statement_frequency": "monthly",
    "billing": {
      "invoice_address_1": "Suite E, 5 The Briars",
      "invoice_address_2": "Waterberry Drive",
      "invoice_town_city": "Waterlooville",
      "invoice_county": "Hampshire",
      "invoice_postcode": "PO7 7YH",
      "invoice_country": "United Kingdom",
      "invoice_email": "gareth@codepotato.co.uk"
    },
    "task_board_template": "App\\Http\\Resources\\Board\\BoardResource",
    "ip_whitelist": [
      "192.168.0.1",
      "127.0.0.1"
    ],
    "welcome_paragraph_html": "<h1>Welcome.</h1>",
    "email_welcome_paragraph_html": "Welcome to Plannr!",
    "show_fact_find_illustrations": true,
    "cc_email_addresses": [
      "jack@example.com",
      "jill@example.com"
    ],
    "bcc_email_addresses": [
      "jack@example.com",
      "jill@example.com"
    ],
    "reply_to_email_address": "jack@example.com",
    "mobile_app_support_number": "01234 567890",
    "mobile_app_support_email": "support@example.com"
  },
  "primary_phone_number": {
    "uuid": "452a9573-9b21-4901-9c06-f8c659b4bad7",
    "created_at": "2026-04-29T12:52:59+01:00",
    "updated_at": "2026-04-29T12:52:59+01:00",
    "type": "phone_number",
    "name": "Work number",
    "value": "+443330903630",
    "phone_number_meta": {
      "country": "GB",
      "formatted": "0333 090 3630"
    },
    "accounts": "App\\Http\\Resources\\AccountResource"
  },
  "primary_email": {
    "uuid": "8e9b3f99-4849-4f17-9b2f-29d984910241",
    "created_at": "2026-04-29T12:52:59+01:00",
    "updated_at": "2026-04-29T12:52:59+01:00",
    "type": "phone_number",
    "name": "Work number",
    "value": "+443330903630",
    "phone_number_meta": {
      "country": "GB",
      "formatted": "0333 090 3630"
    },
    "accounts": "App\\Http\\Resources\\AccountResource"
  },
  "current_time_entry": {
    "uuid": "77d9f656-8ed3-4a1c-9c05-c9914c31b737",
    "created_at": "2026-04-29T12:52:59+01:00",
    "updated_at": "2026-04-29T12:52:59+01:00",
    "name": "Research",
    "description": "This is a description.",
    "trackable_type": "Client",
    "trackable": "App\\Http\\Resources\\MinimalAccountResource",
    "start_date": "2026-04-29T12:02:59+01:00",
    "end_date": "2026-04-29T12:30:59+01:00",
    "is_active": true,
    "total_time_in_minutes": 28,
    "computed_time_elapsed_in_seconds": 1680,
    "account": "App\\Http\\Resources\\MinimalAccountResource"
  },
  "assigned_adviser": {
    "uuid": "fde251ac-0249-4eae-bd7f-1633d1822649",
    "created_at": "2026-04-29T12:52:59+01:00",
    "updated_at": "2026-04-29T12:52:59+01:00",
    "type": "client",
    "role": "client",
    "first_name": "Gareth",
    "last_name": "Thompson",
    "name": "Gareth Thompson",
    "email": "gareth@codepotato.co.uk",
    "photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
    "firm": "App\\Http\\Resources\\FirmResource",
    "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
    "primary_email": "App\\Http\\Resources\\ContactDetailResource",
    "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
    "assigned_adviser": "App\\Http\\Resources\\AccountResource",
    "assigned_administrator": "App\\Http\\Resources\\AccountResource",
    "assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
    "introduced_by": "App\\Http\\Resources\\AccountResource",
    "business_unit": "App\\Http\\Resources\\BusinessUnitResource",
    "groups": "App\\Http\\Resources\\GroupResource",
    "tags": "App\\Http\\Resources\\TagResource",
    "owners": "App\\Http\\Resources\\AccountResource",
    "first_contact_date": "2026-04-29T12:52:59+01:00",
    "next_review_date": "2026-04-29T12:52:59+01:00",
    "previous_review_date": "2026-04-29T12:52:59+01:00",
    "anniversary_review_date": "2026-04-29T12:52:59+01:00",
    "with_login": true,
    "has_joint_account": true,
    "can_be_deleted": "false",
    "joint_account_circle": "App\\Http\\Resources\\CircleResource",
    "circles": "App\\Http\\Resources\\CircleResource",
    "ownership_percentage": 100,
    "inactive_at": "2026-04-29",
    "last_interaction_at": "2026-04-29 12:52:59",
    "referral_code": "ABC12345",
    "permissions": {
      "firm:read": [
        "firm"
      ],
      "network:read": [
        "network:uuid"
      ]
    },
    "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "assigned_administrator": {
    "uuid": "d9b8f8e9-ae34-4768-a55d-9894b085e858",
    "created_at": "2026-04-29T12:52:59+01:00",
    "updated_at": "2026-04-29T12:52:59+01:00",
    "type": "client",
    "role": "client",
    "first_name": "Gareth",
    "last_name": "Thompson",
    "name": "Gareth Thompson",
    "email": "gareth@codepotato.co.uk",
    "photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
    "firm": "App\\Http\\Resources\\FirmResource",
    "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
    "primary_email": "App\\Http\\Resources\\ContactDetailResource",
    "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
    "assigned_adviser": "App\\Http\\Resources\\AccountResource",
    "assigned_administrator": "App\\Http\\Resources\\AccountResource",
    "assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
    "introduced_by": "App\\Http\\Resources\\AccountResource",
    "business_unit": "App\\Http\\Resources\\BusinessUnitResource",
    "groups": "App\\Http\\Resources\\GroupResource",
    "tags": "App\\Http\\Resources\\TagResource",
    "owners": "App\\Http\\Resources\\AccountResource",
    "first_contact_date": "2026-04-29T12:52:59+01:00",
    "next_review_date": "2026-04-29T12:52:59+01:00",
    "previous_review_date": "2026-04-29T12:52:59+01:00",
    "anniversary_review_date": "2026-04-29T12:52:59+01:00",
    "with_login": true,
    "has_joint_account": true,
    "can_be_deleted": "false",
    "joint_account_circle": "App\\Http\\Resources\\CircleResource",
    "circles": "App\\Http\\Resources\\CircleResource",
    "ownership_percentage": 100,
    "inactive_at": "2026-04-29",
    "last_interaction_at": "2026-04-29 12:52:59",
    "referral_code": "ABC12345",
    "permissions": {
      "firm:read": [
        "firm"
      ],
      "network:read": [
        "network:uuid"
      ]
    },
    "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "assigned_paraplanner": {
    "uuid": "30a04070-772f-4837-9a4e-aefb9ee3ebb0",
    "created_at": "2026-04-29T12:52:59+01:00",
    "updated_at": "2026-04-29T12:52:59+01:00",
    "type": "client",
    "role": "client",
    "first_name": "Gareth",
    "last_name": "Thompson",
    "name": "Gareth Thompson",
    "email": "gareth@codepotato.co.uk",
    "photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
    "firm": "App\\Http\\Resources\\FirmResource",
    "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
    "primary_email": "App\\Http\\Resources\\ContactDetailResource",
    "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
    "assigned_adviser": "App\\Http\\Resources\\AccountResource",
    "assigned_administrator": "App\\Http\\Resources\\AccountResource",
    "assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
    "introduced_by": "App\\Http\\Resources\\AccountResource",
    "business_unit": "App\\Http\\Resources\\BusinessUnitResource",
    "groups": "App\\Http\\Resources\\GroupResource",
    "tags": "App\\Http\\Resources\\TagResource",
    "owners": "App\\Http\\Resources\\AccountResource",
    "first_contact_date": "2026-04-29T12:52:59+01:00",
    "next_review_date": "2026-04-29T12:52:59+01:00",
    "previous_review_date": "2026-04-29T12:52:59+01:00",
    "anniversary_review_date": "2026-04-29T12:52:59+01:00",
    "with_login": true,
    "has_joint_account": true,
    "can_be_deleted": "false",
    "joint_account_circle": "App\\Http\\Resources\\CircleResource",
    "circles": "App\\Http\\Resources\\CircleResource",
    "ownership_percentage": 100,
    "inactive_at": "2026-04-29",
    "last_interaction_at": "2026-04-29 12:52:59",
    "referral_code": "ABC12345",
    "permissions": {
      "firm:read": [
        "firm"
      ],
      "network:read": [
        "network:uuid"
      ]
    },
    "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "introduced_by": {
    "uuid": "a32a1ba5-52e3-44e3-a3dc-d0424624d799",
    "created_at": "2026-04-29T12:52:59+01:00",
    "updated_at": "2026-04-29T12:52:59+01:00",
    "type": "client",
    "role": "client",
    "first_name": "Gareth",
    "last_name": "Thompson",
    "name": "Gareth Thompson",
    "email": "gareth@codepotato.co.uk",
    "photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
    "firm": "App\\Http\\Resources\\FirmResource",
    "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
    "primary_email": "App\\Http\\Resources\\ContactDetailResource",
    "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
    "assigned_adviser": "App\\Http\\Resources\\AccountResource",
    "assigned_administrator": "App\\Http\\Resources\\AccountResource",
    "assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
    "introduced_by": "App\\Http\\Resources\\AccountResource",
    "business_unit": "App\\Http\\Resources\\BusinessUnitResource",
    "groups": "App\\Http\\Resources\\GroupResource",
    "tags": "App\\Http\\Resources\\TagResource",
    "owners": "App\\Http\\Resources\\AccountResource",
    "first_contact_date": "2026-04-29T12:52:59+01:00",
    "next_review_date": "2026-04-29T12:52:59+01:00",
    "previous_review_date": "2026-04-29T12:52:59+01:00",
    "anniversary_review_date": "2026-04-29T12:52:59+01:00",
    "with_login": true,
    "has_joint_account": true,
    "can_be_deleted": "false",
    "joint_account_circle": "App\\Http\\Resources\\CircleResource",
    "circles": "App\\Http\\Resources\\CircleResource",
    "ownership_percentage": 100,
    "inactive_at": "2026-04-29",
    "last_interaction_at": "2026-04-29 12:52:59",
    "referral_code": "ABC12345",
    "permissions": {
      "firm:read": [
        "firm"
      ],
      "network:read": [
        "network:uuid"
      ]
    },
    "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "business_unit": {
    "uuid": "3b29af79-87a2-4292-8618-6090fbd2cf50",
    "name": "Wealth Management",
    "has_alternative_branding": false,
    "brand_colours": [],
    "members_count": 3,
    "members": "App\\Http\\Resources\\AccountResource",
    "groups_count": 2,
    "groups": "App\\Http\\Resources\\GroupResource",
    "firm": "App\\Http\\Resources\\FirmResource",
    "created_at": "2026-04-29T12:52:59+01:00",
    "updated_at": "2026-04-29T12:52:59+01:00"
  },
  "groups": [
    {
      "uuid": "151bc0b8-1871-440a-b4c4-33d54aa89492",
      "name": "finance",
      "slug": "finance",
      "participants_count": "3",
      "participants": {
        "uuid": {
          "example": "595b13b3-ab1a-49d9-849e-339f364e3b88",
          "description": "UUID of the account"
        },
        "role": {
          "example": "client",
          "description": "Role of the account"
        },
        "first_name": {
          "example": "Gareth",
          "description": "First name of the account"
        },
        "last_name": {
          "example": "Thompson",
          "description": "Last name of the account"
        },
        "name": {
          "example": "Gareth Thompson",
          "description": "Name of the account"
        },
        "email": {
          "example": "gareth@codepotato.co.uk",
          "description": "Email of the account"
        }
      },
      "created_at": "2026-04-29T12:52:59+01:00",
      "updated_at": "2026-04-29T12:52:59+01:00"
    }
  ],
  "tags": [
    {
      "uuid": "d848d957-f1ba-4999-b982-2b0cf276c6ed",
      "created_at": "2026-04-29T12:52:59+01:00",
      "updated_at": "2026-04-29T12:52:59+01:00",
      "name": "Mortgage",
      "slug": "mortgage",
      "colour": "#ef4582"
    }
  ],
  "owners": [
    {
      "uuid": "1e27608a-1b93-4f0c-ab1c-a375b016349c",
      "created_at": "2026-04-29T12:52:59+01:00",
      "updated_at": "2026-04-29T12:52:59+01:00",
      "type": "client",
      "role": "client",
      "first_name": "Gareth",
      "last_name": "Thompson",
      "name": "Gareth Thompson",
      "email": "gareth@codepotato.co.uk",
      "photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
      "firm": "App\\Http\\Resources\\FirmResource",
      "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
      "primary_email": "App\\Http\\Resources\\ContactDetailResource",
      "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
      "assigned_adviser": "App\\Http\\Resources\\AccountResource",
      "assigned_administrator": "App\\Http\\Resources\\AccountResource",
      "assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
      "introduced_by": "App\\Http\\Resources\\AccountResource",
      "business_unit": "App\\Http\\Resources\\BusinessUnitResource",
      "groups": "App\\Http\\Resources\\GroupResource",
      "tags": "App\\Http\\Resources\\TagResource",
      "owners": "App\\Http\\Resources\\AccountResource",
      "first_contact_date": "2026-04-29T12:52:59+01:00",
      "next_review_date": "2026-04-29T12:52:59+01:00",
      "previous_review_date": "2026-04-29T12:52:59+01:00",
      "anniversary_review_date": "2026-04-29T12:52:59+01:00",
      "with_login": true,
      "has_joint_account": true,
      "can_be_deleted": "false",
      "joint_account_circle": "App\\Http\\Resources\\CircleResource",
      "circles": "App\\Http\\Resources\\CircleResource",
      "ownership_percentage": 100,
      "inactive_at": "2026-04-29",
      "last_interaction_at": "2026-04-29 12:52:59",
      "referral_code": "ABC12345",
      "permissions": {
        "firm:read": [
          "firm"
        ],
        "network:read": [
          "network:uuid"
        ]
      },
      "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
      "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
    }
  ],
  "first_contact_date": "2026-04-29T12:52:59+01:00",
  "next_review_date": "2026-04-29T12:52:59+01:00",
  "previous_review_date": "2026-04-29T12:52:59+01:00",
  "anniversary_review_date": "2026-04-29T12:52:59+01:00",
  "with_login": true,
  "has_joint_account": true,
  "can_be_deleted": "false",
  "joint_account_circle": {
    "uuid": "f3286df5-fe9a-4080-810a-9b1e4a402be5",
    "created_at": "2026-04-29T12:52:59+01:00",
    "updated_at": "2026-04-29T12:52:59+01:00",
    "name": "Jones Family",
    "photo_url": "https://eu.ui-avatars.com/api/?name=jones+family",
    "bg_colour": "#35f4e1",
    "accounts": "App\\Http\\Resources\\AccountResource",
    "groups": "App\\Http\\Resources\\GroupResource",
    "joint_account_uuid": "16579af7-a774-4938-b435-34b6bc14c39c",
    "login_access_level": "write",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "circles": [
    {
      "uuid": "e9c323b3-bf00-409a-b7fc-9c961c54ab59",
      "created_at": "2026-04-29T12:52:59+01:00",
      "updated_at": "2026-04-29T12:52:59+01:00",
      "name": "Jones Family",
      "photo_url": "https://eu.ui-avatars.com/api/?name=jones+family",
      "bg_colour": "#35f4e1",
      "accounts": "App\\Http\\Resources\\AccountResource",
      "groups": "App\\Http\\Resources\\GroupResource",
      "joint_account_uuid": "e2f01f9c-81de-4801-aa27-cbaa681dd77f",
      "login_access_level": "write",
      "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
    }
  ],
  "ownership_percentage": 100,
  "inactive_at": "2026-04-29",
  "last_interaction_at": "2026-04-29 12:52:59",
  "referral_code": "ABC12345",
  "permissions": {
    "firm:read": [
      "firm"
    ],
    "network:read": [
      "network:uuid"
    ]
  },
  "custom_fields": [
    {
      "uuid": "5ff745dc-8b31-46fc-91f0-eaa30676a381",
      "created_at": "2026-04-29T12:52:59+01:00",
      "updated_at": "2026-04-29T12:52:59+01:00",
      "type": "string",
      "name": "Favourite Drink",
      "reference": "favourite_drink",
      "is_required": false,
      "value": "Coffee",
      "selection_options": [
        "Coffee",
        "Tea",
        "Water"
      ],
      "help_text": "This is the client's favourite drink."
    }
  ],
  "external_references": [
    {
      "uuid": "096a684e-fc32-4d00-b7ef-104703e27ee4",
      "created_at": "2026-04-29T12:52:59+01:00",
      "updated_at": "2026-04-29T12:52:59+01:00",
      "third_party": "nucleus",
      "reference": "AB123456"
    }
  ]
}