Create a plan

POST /api/v1/plans

Headers

  • X-PLANNR-ACCOUNT-UUID string
application/json

Body Required

  • name string

    Descriptive name of the plan

  • client_uuid string Required

    [DEPRACATED] Please use accounts instead. Account uuid linked with the plan

  • accounts array[string]

    Accounts that own this plan, along with their percentage ownership. Any percentages that have not be defined will be split equally against the remaining percentage.

  • type string Required

    Type of plan, must be one of these types: annuity, cash_account, fixed_asset, general_insurance, group_protection, investment, loan_credit, mortgage, pension and protection_policy

  • sub_type string Required

    Plan sub type

  • provider_uuid string Required

    uuid of the provider

  • policy_number string

    Main policy number for the plan, will be stored as the main accounts policy number

  • proposal_reference string

    Main proposal reference for the plan, will be stored as the main accounts proposal reference

  • opened_at string

    date when the plan was purchased or account was opened

  • status string Required

    Status of plan, must be one of these types: active, inactive and proposed

  • inactive_at date

    Date when plan went inactive

  • inactive_reason string

    Reason of inactivity, must be one of these types: accepted, agency_transferred, cancelled, claimed, complete, death_event, deferred, drawdown, expired, full_drawdown, issued, lapsed, matured, not_proceeded_with, not_taken_up, offered, paid_up, partial_drawdown, partial_surrender, proposed, prospect, refunded, refused, surrendered, transfer, transferred, underwriting, vested, declined, encashment, left_service, premium_holiday and other

  • agency_in_your_name boolean

    Agency in your name

  • agency_in_your_name_from date

    Date agency was in your name from

  • originally_sold_by_firm boolean

    Whether the plan was originally sold by your firm

  • under_advice boolean

    Under advice

  • visible_on_client_portal boolean

    Whether this plan will be shown to clients in their client portal. Will default to true if not provided.

  • include_in_client_valuation boolean

    Include in client valuation. Will default to true if not provided.

  • show_on_joint boolean

    If the plan belongs to an individual account, then you can opt to also show this plan on any joint accounts the individual client belongs to, otherwise value is ignored. Will default to false if not provided.

  • review_date date

    Next review date

  • on_panel boolean Required

    On panel

  • seller_uuid string

    Employee account that sold this plan

  • active_adviser_uuid string

    Employee account that is managing this plan

  • adviser_split_uuid string

    A plan adviser split to be applied to charges to this plan

  • cases array[string]

    Array of case uuids

  • linked_owners array[string]

    Linked clients who should be added as extra owners of the plan.

  • current_value integer

    The current value of the plan in pennies. Can be provided with current_value_at to specify the date that the plan was valued at.

  • current_value_at date

    Optional date to be used with current_value. If left blank it will default to the current day.

  • is_group_scheme boolean

    Denotes if the plan is a group scheme plan. When a plan is a group scheme plan you will be able to manage group scheme members and sub schemes. Only business clients can have group schemes. Will default to false if not provided.

  • is_wrap_product boolean

    Denotes if the plan is a wrap product, and can have plans linked under it. Will default to false if not provided.

  • wrap_uuid string

    The UUID of the wrap product to link this plan too

  • contract_enquiry_account_uuid string

    The UUID of the account used for contract enquiry.

  • beneficiaries array[string]

    The beneficiaries of the plan.

  • platform_provider string

    platform_provider field, this is found on types (annuity cash_account investment pension)

  • life_assured string

    life_assured field, this is found on types (annuity)

  • sum_assured string

    sum_assured field, this is found on types (annuity)

  • term_type string

    term_type field, this is found on types (annuity cash_account general_insurance group_protection investment loan_credit mortgage pension protection_policy)

  • term_maturity_date string

    term_maturity_date field, this is found on types (annuity cash_account general_insurance investment loan_credit mortgage pension protection_policy)

  • term_age string

    term_age field, this is found on types (annuity cash_account general_insurance investment loan_credit mortgage pension protection_policy)

  • term_maturity_value string

    term_maturity_value field, this is found on types (annuity)

  • guaranteed_term string

    guaranteed_term field, this is found on types (annuity)

  • payment_type string

    payment_type field, this is found on types (annuity)

  • income_amount string

    income_amount field, this is found on types (annuity)

  • income_frequency string

    income_frequency field, this is found on types (annuity)

  • income_from string

    income_from field, this is found on types (annuity)

  • income_escalation string

    income_escalation field, this is found on types (annuity)

  • initial_purchase_amount string

    initial_purchase_amount field, this is found on types (annuity)

  • interest_type string

    interest_type field, this is found on types (cash_account investment loan_credit mortgage)

  • interest_rate string

    interest_rate field, this is found on types (cash_account investment loan_credit mortgage)

  • address_1 string

    address_1 field, this is found on types (fixed_asset)

  • address_2 string

    address_2 field, this is found on types (fixed_asset)

  • address_3 string

    address_3 field, this is found on types (fixed_asset)

  • address_4 string

    address_4 field, this is found on types (fixed_asset)

  • town_city string

    town_city field, this is found on types (fixed_asset)

  • county string

    county field, this is found on types (fixed_asset)

  • postcode string

    postcode field, this is found on types (fixed_asset)

  • country string

    country field, this is found on types (fixed_asset)

  • new_property string

    new_property field, this is found on types (fixed_asset)

  • price_listed string

    price_listed field, this is found on types (fixed_asset)

  • purchase_price string

    purchase_price field, this is found on types (fixed_asset)

  • asset_description string

    asset_description field, this is found on types (fixed_asset)

  • asset_image string

    asset_image field, this is found on types (fixed_asset)

  • ncd string

    ncd field, this is found on types (general_insurance)

  • ncd_protected string

    ncd_protected field, this is found on types (general_insurance)

  • ncd_years string

    ncd_years field, this is found on types (general_insurance)

  • renewal_date string

    renewal_date field, this is found on types (general_insurance group_protection)

  • offshore string

    offshore field, this is found on types (investment)

  • in_trust string

    in_trust field, this is found on types (investment protection_policy)

  • trustee_details string

    trustee_details field, this is found on types (investment protection_policy)

  • original_balance string

    original_balance field, this is found on types (loan_credit mortgage)

  • outstanding_balance string

    outstanding_balance field, this is found on types (loan_credit mortgage)

  • loan_amount string

    loan_amount field, this is found on types (loan_credit)

  • repayment_amount string

    repayment_amount field, this is found on types (loan_credit)

  • repayment_frequency string

    repayment_frequency field, this is found on types (loan_credit)

  • details string

    details field, this is found on types (loan_credit)

  • property_type string

    property_type field, this is found on types (mortgage)

  • payment_amount string

    payment_amount field, this is found on types (mortgage)

  • payment_frequency string

    payment_frequency field, this is found on types (mortgage)

  • initial_interest string

    initial_interest field, this is found on types (mortgage)

  • initial_period_end string

    initial_period_end field, this is found on types (mortgage)

  • initial_payment string

    initial_payment field, this is found on types (mortgage)

  • equity_released string

    equity_released field, this is found on types (mortgage)

  • loan_quote string

    loan_quote field, this is found on types (mortgage)

  • loan_type string

    loan_type field, this is found on types (mortgage)

  • mig_added string

    mig_added field, this is found on types (mortgage)

  • mig_premium string

    mig_premium field, this is found on types (mortgage)

  • repayment_type string

    repayment_type field, this is found on types (mortgage)

  • repayment_method string

    repayment_method field, this is found on types (mortgage)

  • repayment_term string

    repayment_term field, this is found on types (mortgage)

  • other_repayment_method string

    other_repayment_method field, this is found on types (mortgage)

  • scheme_fixed_date string

    scheme_fixed_date field, this is found on types (mortgage)

  • transaction_details string

    transaction_details field, this is found on types (mortgage)

  • base_payment string

    base_payment field, this is found on types (mortgage)

  • has_transfer_penalties string

    has_transfer_penalties field, this is found on types (mortgage)

  • is_portable_mortgage string

    is_portable_mortgage field, this is found on types (mortgage)

  • transfer_penalty string

    transfer_penalty field, this is found on types (mortgage)

  • contract_exchanged string

    contract_exchanged field, this is found on types (mortgage)

  • date_complete string

    date_complete field, this is found on types (mortgage)

  • date_confirmed string

    date_confirmed field, this is found on types (mortgage)

  • date_exchanged string

    date_exchanged field, this is found on types (mortgage)

  • date_submitted string

    date_submitted field, this is found on types (mortgage)

  • mortgage_completed string

    mortgage_completed field, this is found on types (mortgage)

  • offer_confirmed string

    offer_confirmed field, this is found on types (mortgage)

  • offer_confirmed_date string

    offer_confirmed_date field, this is found on types (mortgage)

  • offer_date string

    offer_date field, this is found on types (mortgage)

  • offer_issued string

    offer_issued field, this is found on types (mortgage)

  • on_risk string

    on_risk field, this is found on types (mortgage)

  • proposal_date string

    proposal_date field, this is found on types (mortgage)

  • submitted string

    submitted field, this is found on types (mortgage)

  • declined_notes string

    declined_notes field, this is found on types (mortgage)

  • accrual_rate string

    accrual_rate field, this is found on types (pension)

  • year_accrued string

    year_accrued field, this is found on types (pension)

  • retirement_date string

    retirement_date field, this is found on types (pension)

  • pensionable_salary string

    pensionable_salary field, this is found on types (pension)

  • transfer_value string

    transfer_value field, this is found on types (pension)

  • date_of_transfer_valuation string

    date_of_transfer_valuation field, this is found on types (pension)

  • widows_percentage string

    widows_percentage field, this is found on types (pension)

  • contracted_out string

    contracted_out field, this is found on types (pension)

  • had_avc string

    had_avc field, this is found on types (pension)

  • in_house_avc_amount string

    in_house_avc_amount field, this is found on types (pension)

  • in_house_avc_percentage string

    in_house_avc_percentage field, this is found on types (pension)

  • death_benefit_amount string

    death_benefit_amount field, this is found on types (pension)

  • projected_income string

    projected_income field, this is found on types (pension)

  • plan_retirement_age string

    plan_retirement_age field, this is found on types (pension)

  • state_retirement_age string

    state_retirement_age field, this is found on types (pension)

  • salary_sacrifice string

    salary_sacrifice field, this is found on types (pension)

  • waiver string

    waiver field, this is found on types (pension)

  • is_crystallised string

    is_crystallised field, this is found on types (pension)

  • crystallisation_amount string

    crystallisation_amount field, this is found on types (pension)

  • crystallisation_benefit string

    crystallisation_benefit field, this is found on types (pension)

  • crystallisation_fund string

    crystallisation_fund field, this is found on types (pension)

  • crystallisation_start_date string

    crystallisation_start_date field, this is found on types (pension)

  • crystallisation_end_date string

    crystallisation_end_date field, this is found on types (pension)

  • crystallisation_frequency string

    crystallisation_frequency field, this is found on types (pension)

  • fund_amount string

    fund_amount field, this is found on types (pension)

  • uncrystallised_fund string

    uncrystallised_fund field, this is found on types (pension)

  • income_taken_amount string

    income_taken_amount field, this is found on types (pension)

  • maximum_income_amount string

    maximum_income_amount field, this is found on types (pension)

  • tax_free_amount string

    tax_free_amount field, this is found on types (pension)

  • lifetime_allowance_percentage string

    lifetime_allowance_percentage field, this is found on types (pension)

  • lta_applied string

    lta_applied field, this is found on types (pension)

  • mpaa_trigger string

    mpaa_trigger field, this is found on types (pension)

  • pcls_percentage string

    pcls_percentage field, this is found on types (pension)

  • reason string

    reason field, this is found on types (pension)

  • has_pre_existing_conditions string

    has_pre_existing_conditions field, this is found on types (protection_policy)

  • pre_existing_conditions_notes string

    pre_existing_conditions_notes field, this is found on types (protection_policy)

  • external_reference array[string]

    A third-party external reference to attach when creating the model. The third party must be one of the following: adviser_office, aj_bell, be_iq_organisation, conquest, filehaven, finio, fundment, intelliflo_office, nucleus, parmenion, seccl, smartsearch, soderberg and transact_remuneration

Responses

  • 401 application/json
    Hide response attribute Show response attribute object
    • message string
POST /api/v1/plans
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/plans' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"name":"Johns ISA","client_uuid":"96bb6289-1680-4961-a9f0-f9e484288952","accounts":[{"account_uuid":"b5119864-cbb3-4cc4-846c-0c86a8a9f39b"},{"account_uuid":"f1b0ecac-6496-49a6-93ae-c2ade05beb88","ownership_percentage":75.0},{"account_uuid":"a45bd61f-e145-448e-bcb0-e26fd933f560","ownership_percentage":null}],"type":"cash_account","sub_type":"lifetime_isa_cash","provider_uuid":"ab2dcbdf-4fb3-46d7-a800-81b48cd4def2","policy_number":"AVI-43135","proposal_reference":"AB12345","opened_at":"2025-06-26","status":"active","inactive_at":"2025-06-26","inactive_reason":"refunded","agency_in_your_name":true,"agency_in_your_name_from":"2025-03-18","originally_sold_by_firm":true,"under_advice":true,"visible_on_client_portal":true,"include_in_client_valuation":true,"show_on_joint":true,"review_date":"2026-06-26","on_panel":true,"seller_uuid":"e2375909-b287-430e-96a6-30e4345ceae0","active_adviser_uuid":"412ae1d8-b166-40a4-b468-90ff6ad58529","adviser_split_uuid":"8923e6c3-1aaa-4c89-89dd-1f0d9f0e9966","cases":["77b54df8-f719-449c-9803-1032736bf68d","ffe98c2e-4cfe-4a6a-b4ad-d0f9a96f03d5"],"linked_owners":["80335422-723b-46f0-91b0-151eadc18b90","2bf4a251-0ca2-4a7f-ad4d-b9b4070de16a"],"current_value":5000,"current_value_at":"2025-06-26T11:37:07+01:00","is_group_scheme":false,"is_wrap_product":false,"wrap_uuid":"72b3a504-d8fa-45fa-b940-6c991b395ca8","contract_enquiry_account_uuid":"7621ddea-841a-41e1-872a-031268ae7ba3","beneficiaries":[{"name":"John Smith","percentage":20.5},{"name":"Jane Doe","percentage":50.5}],"platform_provider":"(platform_provider)","life_assured":"(life_assured)","sum_assured":"(sum_assured)","term_type":"(term_type)","term_maturity_date":"(term_maturity_date)","term_age":"(term_age)","term_maturity_value":"(term_maturity_value)","guaranteed_term":"(guaranteed_term)","payment_type":"(payment_type)","income_amount":"(income_amount)","income_frequency":"(income_frequency)","income_from":"(income_from)","income_escalation":"(income_escalation)","initial_purchase_amount":"(initial_purchase_amount)","interest_type":"(interest_type)","interest_rate":"(interest_rate)","address_1":"(address_1)","address_2":"(address_2)","address_3":"(address_3)","address_4":"(address_4)","town_city":"(town_city)","county":"(county)","postcode":"(postcode)","country":"(country)","new_property":"(new_property)","price_listed":"(price_listed)","purchase_price":"(purchase_price)","asset_description":"(asset_description)","asset_image":"(asset_image)","ncd":"(ncd)","ncd_protected":"(ncd_protected)","ncd_years":"(ncd_years)","renewal_date":"(renewal_date)","offshore":"(offshore)","in_trust":"(in_trust)","trustee_details":"(trustee_details)","original_balance":"(original_balance)","outstanding_balance":"(outstanding_balance)","loan_amount":"(loan_amount)","repayment_amount":"(repayment_amount)","repayment_frequency":"(repayment_frequency)","details":"(details)","property_type":"(property_type)","payment_amount":"(payment_amount)","payment_frequency":"(payment_frequency)","initial_interest":"(initial_interest)","initial_period_end":"(initial_period_end)","initial_payment":"(initial_payment)","equity_released":"(equity_released)","loan_quote":"(loan_quote)","loan_type":"(loan_type)","mig_added":"(mig_added)","mig_premium":"(mig_premium)","repayment_type":"(repayment_type)","repayment_method":"(repayment_method)","repayment_term":"(repayment_term)","other_repayment_method":"(other_repayment_method)","scheme_fixed_date":"(scheme_fixed_date)","transaction_details":"(transaction_details)","base_payment":"(base_payment)","has_transfer_penalties":"(has_transfer_penalties)","is_portable_mortgage":"(is_portable_mortgage)","transfer_consent":"(transfer_consent)","transfer_penalty":"(transfer_penalty)","contract_exchanged":"(contract_exchanged)","date_complete":"(date_complete)","date_confirmed":"(date_confirmed)","date_exchanged":"(date_exchanged)","date_submitted":"(date_submitted)","mortgage_completed":"(mortgage_completed)","offer_confirmed":"(offer_confirmed)","offer_confirmed_date":"(offer_confirmed_date)","offer_date":"(offer_date)","offer_issued":"(offer_issued)","on_risk":"(on_risk)","proposal_date":"(proposal_date)","submitted":"(submitted)","declined_notes":"(declined_notes)","accrual_rate":"(accrual_rate)","year_accrued":"(year_accrued)","retirement_date":"(retirement_date)","pensionable_salary":"(pensionable_salary)","transfer_value":"(transfer_value)","date_of_transfer_valuation":"(date_of_transfer_valuation)","widows_percentage":"(widows_percentage)","contracted_out":"(contracted_out)","had_avc":"(had_avc)","in_house_avc_amount":"(in_house_avc_amount)","in_house_avc_percentage":"(in_house_avc_percentage)","death_benefit_amount":"(death_benefit_amount)","projected_income":"(projected_income)","plan_retirement_age":"(plan_retirement_age)","state_retirement_age":"(state_retirement_age)","salary_sacrifice":"(salary_sacrifice)","waiver":"(waiver)","is_crystallised":"(is_crystallised)","crystallisation_amount":"(crystallisation_amount)","crystallisation_benefit":"(crystallisation_benefit)","crystallisation_fund":"(crystallisation_fund)","crystallisation_start_date":"(crystallisation_start_date)","crystallisation_end_date":"(crystallisation_end_date)","crystallisation_frequency":"(crystallisation_frequency)","fund_amount":"(fund_amount)","uncrystallised_fund":"(uncrystallised_fund)","income_taken_amount":"(income_taken_amount)","maximum_income_amount":"(maximum_income_amount)","tax_free_amount":"(tax_free_amount)","lifetime_allowance_percentage":"(lifetime_allowance_percentage)","lta_applied":"(lta_applied)","mpaa_trigger":"(mpaa_trigger)","pcls_percentage":"(pcls_percentage)","reason":"(reason)","has_pre_existing_conditions":"(has_pre_existing_conditions)","pre_existing_conditions_notes":"(pre_existing_conditions_notes)","external_reference":[{"reference":"AB123456","third_party":"nucleus"}]}'
Request examples
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "name": "Johns ISA",
  "client_uuid": "96bb6289-1680-4961-a9f0-f9e484288952",
  "accounts": [
    {
      "account_uuid": "b5119864-cbb3-4cc4-846c-0c86a8a9f39b"
    },
    {
      "account_uuid": "f1b0ecac-6496-49a6-93ae-c2ade05beb88",
      "ownership_percentage": 75.0
    },
    {
      "account_uuid": "a45bd61f-e145-448e-bcb0-e26fd933f560",
      "ownership_percentage": null
    }
  ],
  "type": "cash_account",
  "sub_type": "lifetime_isa_cash",
  "provider_uuid": "ab2dcbdf-4fb3-46d7-a800-81b48cd4def2",
  "policy_number": "AVI-43135",
  "proposal_reference": "AB12345",
  "opened_at": "2025-06-26",
  "status": "active",
  "inactive_at": "2025-06-26",
  "inactive_reason": "refunded",
  "agency_in_your_name": true,
  "agency_in_your_name_from": "2025-03-18",
  "originally_sold_by_firm": true,
  "under_advice": true,
  "visible_on_client_portal": true,
  "include_in_client_valuation": true,
  "show_on_joint": true,
  "review_date": "2026-06-26",
  "on_panel": true,
  "seller_uuid": "e2375909-b287-430e-96a6-30e4345ceae0",
  "active_adviser_uuid": "412ae1d8-b166-40a4-b468-90ff6ad58529",
  "adviser_split_uuid": "8923e6c3-1aaa-4c89-89dd-1f0d9f0e9966",
  "cases": [
    "77b54df8-f719-449c-9803-1032736bf68d",
    "ffe98c2e-4cfe-4a6a-b4ad-d0f9a96f03d5"
  ],
  "linked_owners": [
    "80335422-723b-46f0-91b0-151eadc18b90",
    "2bf4a251-0ca2-4a7f-ad4d-b9b4070de16a"
  ],
  "current_value": 5000,
  "current_value_at": "2025-06-26T11:37:07+01:00",
  "is_group_scheme": false,
  "is_wrap_product": false,
  "wrap_uuid": "72b3a504-d8fa-45fa-b940-6c991b395ca8",
  "contract_enquiry_account_uuid": "7621ddea-841a-41e1-872a-031268ae7ba3",
  "beneficiaries": [
    {
      "name": "John Smith",
      "percentage": 20.5
    },
    {
      "name": "Jane Doe",
      "percentage": 50.5
    }
  ],
  "platform_provider": "(platform_provider)",
  "life_assured": "(life_assured)",
  "sum_assured": "(sum_assured)",
  "term_type": "(term_type)",
  "term_maturity_date": "(term_maturity_date)",
  "term_age": "(term_age)",
  "term_maturity_value": "(term_maturity_value)",
  "guaranteed_term": "(guaranteed_term)",
  "payment_type": "(payment_type)",
  "income_amount": "(income_amount)",
  "income_frequency": "(income_frequency)",
  "income_from": "(income_from)",
  "income_escalation": "(income_escalation)",
  "initial_purchase_amount": "(initial_purchase_amount)",
  "interest_type": "(interest_type)",
  "interest_rate": "(interest_rate)",
  "address_1": "(address_1)",
  "address_2": "(address_2)",
  "address_3": "(address_3)",
  "address_4": "(address_4)",
  "town_city": "(town_city)",
  "county": "(county)",
  "postcode": "(postcode)",
  "country": "(country)",
  "new_property": "(new_property)",
  "price_listed": "(price_listed)",
  "purchase_price": "(purchase_price)",
  "asset_description": "(asset_description)",
  "asset_image": "(asset_image)",
  "ncd": "(ncd)",
  "ncd_protected": "(ncd_protected)",
  "ncd_years": "(ncd_years)",
  "renewal_date": "(renewal_date)",
  "offshore": "(offshore)",
  "in_trust": "(in_trust)",
  "trustee_details": "(trustee_details)",
  "original_balance": "(original_balance)",
  "outstanding_balance": "(outstanding_balance)",
  "loan_amount": "(loan_amount)",
  "repayment_amount": "(repayment_amount)",
  "repayment_frequency": "(repayment_frequency)",
  "details": "(details)",
  "property_type": "(property_type)",
  "payment_amount": "(payment_amount)",
  "payment_frequency": "(payment_frequency)",
  "initial_interest": "(initial_interest)",
  "initial_period_end": "(initial_period_end)",
  "initial_payment": "(initial_payment)",
  "equity_released": "(equity_released)",
  "loan_quote": "(loan_quote)",
  "loan_type": "(loan_type)",
  "mig_added": "(mig_added)",
  "mig_premium": "(mig_premium)",
  "repayment_type": "(repayment_type)",
  "repayment_method": "(repayment_method)",
  "repayment_term": "(repayment_term)",
  "other_repayment_method": "(other_repayment_method)",
  "scheme_fixed_date": "(scheme_fixed_date)",
  "transaction_details": "(transaction_details)",
  "base_payment": "(base_payment)",
  "has_transfer_penalties": "(has_transfer_penalties)",
  "is_portable_mortgage": "(is_portable_mortgage)",
  "transfer_consent": "(transfer_consent)",
  "transfer_penalty": "(transfer_penalty)",
  "contract_exchanged": "(contract_exchanged)",
  "date_complete": "(date_complete)",
  "date_confirmed": "(date_confirmed)",
  "date_exchanged": "(date_exchanged)",
  "date_submitted": "(date_submitted)",
  "mortgage_completed": "(mortgage_completed)",
  "offer_confirmed": "(offer_confirmed)",
  "offer_confirmed_date": "(offer_confirmed_date)",
  "offer_date": "(offer_date)",
  "offer_issued": "(offer_issued)",
  "on_risk": "(on_risk)",
  "proposal_date": "(proposal_date)",
  "submitted": "(submitted)",
  "declined_notes": "(declined_notes)",
  "accrual_rate": "(accrual_rate)",
  "year_accrued": "(year_accrued)",
  "retirement_date": "(retirement_date)",
  "pensionable_salary": "(pensionable_salary)",
  "transfer_value": "(transfer_value)",
  "date_of_transfer_valuation": "(date_of_transfer_valuation)",
  "widows_percentage": "(widows_percentage)",
  "contracted_out": "(contracted_out)",
  "had_avc": "(had_avc)",
  "in_house_avc_amount": "(in_house_avc_amount)",
  "in_house_avc_percentage": "(in_house_avc_percentage)",
  "death_benefit_amount": "(death_benefit_amount)",
  "projected_income": "(projected_income)",
  "plan_retirement_age": "(plan_retirement_age)",
  "state_retirement_age": "(state_retirement_age)",
  "salary_sacrifice": "(salary_sacrifice)",
  "waiver": "(waiver)",
  "is_crystallised": "(is_crystallised)",
  "crystallisation_amount": "(crystallisation_amount)",
  "crystallisation_benefit": "(crystallisation_benefit)",
  "crystallisation_fund": "(crystallisation_fund)",
  "crystallisation_start_date": "(crystallisation_start_date)",
  "crystallisation_end_date": "(crystallisation_end_date)",
  "crystallisation_frequency": "(crystallisation_frequency)",
  "fund_amount": "(fund_amount)",
  "uncrystallised_fund": "(uncrystallised_fund)",
  "income_taken_amount": "(income_taken_amount)",
  "maximum_income_amount": "(maximum_income_amount)",
  "tax_free_amount": "(tax_free_amount)",
  "lifetime_allowance_percentage": "(lifetime_allowance_percentage)",
  "lta_applied": "(lta_applied)",
  "mpaa_trigger": "(mpaa_trigger)",
  "pcls_percentage": "(pcls_percentage)",
  "reason": "(reason)",
  "has_pre_existing_conditions": "(has_pre_existing_conditions)",
  "pre_existing_conditions_notes": "(pre_existing_conditions_notes)",
  "external_reference": [
    {
      "reference": "AB123456",
      "third_party": "nucleus"
    }
  ]
}
Response examples (401)
{
  "message": "Unauthenticated."
}