Quiz
This API is for the Quiz resource of the Advisor API on the wealth.com platform. It allows connected systems to programmatically fetch the questions and FAQs for the wealth.com quiz and get a recommended plan based on a client's quiz answers and other information. This can be useful for integrating the wealth.com quiz into your platform.
Note: If your api user is set up to have access to multiple advisors, you will need to provide advisor_id
and team_id
query parameters (unless they are specified as part of request object).
Get Quiz
The GET
quiz call expects an integer quiz version to be passed on the URL.
Request
curl --location --request GET 'https://advisor-api.wealth.com/v1/quiz/1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic xxxxxxxxxxxxx'
Get Quiz Response Object
- Name
questions
- Type
- array of objects
- Description
The array of questions to be displayed in the quiz.
- Name
id
- Type
- string (Max 20)
- Description
The unique ID for the question.
- Name
order
- Type
- integer
- Description
The order of the question in relation to the rest of the questions.
- Name
question
- Type
- string (Max 200)
- Description
The text that is displayed to the user for the question.
- Name
tag
- Type
- string (Max 200)
- Description
A short tag that represents the question.
- Name
faq
- Type
- array of objects
- Description
The array of FAQs to be displayed below the quiz.
- Name
title
- Type
- string (Max 200)
- Description
The title text for the FAQ.
- Name
content
- Type
- array of objects
- Description
The array of content objects to be displayed when the FAQ is expanded.
- Name
list_item
- Type
- string (Max 20)
- Description
Indicates whether children of the content item are list items. If this is null, they are not. If this is “bullet” then they are bullet list items.
- Name
mark_defs
- Type
- array of objects
- Description
The array of marks to be used by the children of the content.
- Name
key
- Type
- string (Max 20)
- Description
Indicates whether children of the content item are list items. If this is null, they are not. If this is “bullet” then they are bullet list items.
- Name
href
- Type
- string (Max 200)
- Description
The array of marks to be used by the children of the content.
- Name
children
- Type
- array of objects
- Description
The array of items to be shown to the user for this content.
- Name
marks
- Type
- array of string (Max 20)
- Description
An array of marks for this child to utilize. Each string in this array will match the key of a mark.
- Name
text
- Type
- string (Max 2500)
- Description
The text to be displayed to the user for this child. If this child has marks then this child should be highlighted and link to the related mark’s href.
- Name
side_faq
- Type
- array of objects
- Description
The array of FAQs to be shown to the side of the quiz.
- Name
content
- Type
- string (Max 200)
- Description
The text to be displayed to the user for this side FAQ.
- Name
link_to
- Type
- array of objects
- Description
The array of items to display after this side FAQ is clicked.
- Name
content
- Type
- string (Max 2500)
- Description
The text to be displayed to the user for this linked item.
Response
{
"questions": [{
"id": "8licOO",
"order": 0,
"question": "If I can't manage my own affairs, I want someone to handle my health care and financial decisions.",
"tag": "Financial Decisions"
}],
"faq": [{
"title": "What is the difference between a Last Will & Testament and a Revocable Trust?",
"content": [{
"list_item": null,
"mark_defs": [{
"key": "178367fd4522",
"href": "https://www.youtube.com/watch?v=VLDLO3nhb9Y"
}],
"children": [{
"marks": [],
"text": "A Will and a Trust both allow you to name who will manage your affairs, who will be your beneficiaries, and how your assets will be distributed. However, there are some key differences between both types of legal documents.\n\nFirst, if you create a Will, upon your death the probate court (sometimes called a “surrogate court”) will oversee the process to distribute your assets to your beneficiaries. Because a Will is used in the probate process, it is therefore a publicly available document. A Trust privatizes the administration of your affairs, and will not go through the probate process. \n\nSecond, whereas a Will only takes effect at your death, if you transferred assets into your Trust and something were to happen to you (for example, you are incapacitated), your successor trustee can step in to manage those assets. \n\nTo learn more, you can also watch Anne Rhodes, our Chief Legal Officer, break down the differences between a Will and a Trust here."
},
{
"marks": ["178367fd4522"],
"text": "Watch Video"
}]
},
{
"listItem": "bullet",
"markDefs": [],
"children": [
{
"marks": [],
"text": "Advance Health Care Directive"
}
]
}]
}],
"side_faq": [{
"content": "Do you have a particular person in mind who should handle your financial decisions if you were incapacitated?",
"link_to": [{
"content": "### Do you have a particular person in mind who should handle your health care and financial decisions if you were unable to yourself?"
},
{
"content": "A advance health care directive is a document that allows you to name a person to make health care decisions for you and to leave guidance to that person and your medical team on your health care and post-death decisions. This includes withholding life-sustaining treatments, organ donation and disposition of remains."
}]
}]
}
Get Primary Document Recommendation
Get Primary Document Recommendation Request Object
- Name
version
- Type
- integer
- Description
The quiz version.
- Name
answers
- Type
- array of string (Max 20)
- Description
The question IDs that the client selected in the quiz.
- Name
marital_status
- Type
- string (Max 50)
- Description
Marital status of the client.
Accepted values:'Single' 'Married' 'DomesticPartnership' 'CivilUnion' 'Engaged' 'OtherCommittedRelationship' 'Widowed'
- Name
jurisdiction
- Type
- string (Max 2)
- Description
The jurisdiction where the client lives.
- Name
existing_estate_plan
- Type
- string (Max 50)
- Description
The client's existing estate plan.
Accepted values:'IndividualTrust' 'JointTrust' 'LastWillAndTestament' 'NoEstatePlan' 'Unknown'
Request
curl --location --request POST 'https://advisor-api.wealth.com/v1/quiz' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic xxxxxxxxxxxxx' \
--data-raw '{
"version": 1,
"answers": ["eb94O6", "C81YRs", "9q50xr", "jFffD8"],
"marital_status": "Married",
"jurisdiction": "NY",
"existing_estate_plan": "IndividualTrust"
}
Get Primary Document Recommendation Response Object
- Name
recommended_primary_document
- Type
- string (Max 50)
- Description
The recommended primary document for the client.
Possible values:'One Joint Revocable Trust' 'One Individual Revocable Trust' 'Two Individual Revocable Trusts' 'One Last Will and Testament' 'Two Last Will and Testaments'
- Name
recommended_rationale
- Type
- array of objects
- Description
The array of rationales that explain the primary document recommendation.
- Name
title
- Type
- string (Max 200)
- Description
The title for the rationale.
- Name
content
- Type
- string (Max 2500)
- Description
The text content for the rationale.
- Name
possible_primary_documents
- Type
- array of string (Max 50)
- Description
An array of the primary documents that make sense for the client.
Possible values:'One Joint Revocable Trust' 'One Individual Revocable Trust' 'Two Individual Revocable Trusts' 'One Last Will and Testament' 'Two Last Will and Testaments'
- Name
possible_rationale
- Type
- string (Max 2500)
- Description
An explanation for the possible primary documents array.
Response
{
"recommended_primary_document": "Two Individual Revocable Trusts",
"recommended_rationale": [
{
"title": "You own a business.",
"content": "Business shares can get tied up in the probate process, which can impact its continued operation. Owning those shares through a Revocable Trust passes them to your beneficiaries without court involvement, and your trustee can manage your business until then."
}
],
"possible_primary_documents": [
"One Joint Revocable Trust",
"Two Individual Revocable Trusts",
"Two Last Will and Testaments"
],
"possible_rationale": "Since you are not single, you need a joint revocable trust, two wills, or two individual revocable trusts."
}