Introduction
Yourefolio API is REST API. If you want to use Yourefolio API, you need to contact info@yourefolio.com with the name of your company. Yourefolio will reply to your email with API key for your company. That API key will be used for the authentication purpose.
Making Requests
The base URL for all Yourefolio API requests is https://site.yourefolio.com/api/v1/
If a specific client has API enabled for his private label (PL) site, then base URL will be https://[sub-domain].yourefolio.com/api/v1/
The API is built on RESTful principles with resource-oriented URL endpoints. HTTP status codes are used to indicate any API errors and all responses are returned in JSON format (except for SAML authentication which returns authentication response in XML). All requests must be made over an HTTPS connection to ensure a secure transmission of data. Following a RESTful structure, requests should hit API endpoints using the appropriate HTTP method, which will depend on the desired action:
Method | Description |
---|---|
GET | Use the GET method to retrieve information about your users, their accounts, and any associated financial data. This will always be a read-only request, so queried objects will never be modified by a GET request. |
POST | Use a POST method to create a new object, such as new notes or tokens. Request parameters should be given in JSON format. The response body will typically return the newly created resource. |
Responses
{
{
"client_id": "1112",
"client_name": "John Doe",
"dateOfBirth": "11/11/1990",
"email": "testmail@yourefolio.com"
},
{
"client_id": "1124",
"client_name": "Riddle",
"dateOfBirth": "11/01/2001",
"email": "testmail2@yourefolio.com"
},
}
All non-empty response bodies, including errors, will be formatted as JSON objects. In general, a successful
GET request (or any other request that retrieves data) will return an object with the data contained inside a
single key-value pair. This key is always associated with the relevant endpoint. For example, GET /clients
will return an object with the list of clients as its value.
If you are fetching multiple entries, such as the previous GET /clients
example,
the data will be returned as a list. If you are fetching a single entry, such as GET /clients/1124/personal_information
, the data will be returned as a single object.
Additionally, Yourefolio's APIs use standard HTTP status codes to indicate the status of a request.
Below is a brief overview of the most common status codes:
Code | Definition |
---|---|
200 | OK - The request was successful and there is relevant data in the response body. |
201 | Created - Returned after a new object was created. Typically, the newly created object will be available in the response body. |
204 | No Content - Usually returned on a DELETE request. This indicates that the object was successfully removed, but there is no actual data to return. |
400 | Bad Request - There was an issue with the given parameters. This could be due to a missing required field, a malformed parameter, etc. |
401 | Unauthorized - The API credentials or access token used are incorrect. |
403 | Forbidden - You do not have access to the requested endpoint or action. |
404 | Not Found - Returned if the given resource either does not exist or you do not have access to it. |
500 | Internal Server Error - There are internal or API-related errors on Yourefolio's side. Additional requests will not resolve the issue. |
503 | Service Unavailable - The targeted endpoint is currently unavailable. This is caused by temporary issues; access to the endpoint will return momentarily. |
Errors
{
"error" => "404",
"message" => "No Authorized User Found"
}
If there is an error with your request, a JSON containing an error ID and message will be returned.
The status
will always match the returned HTTP status code. While there are
unique error IDs and messages, most invalid request errors (400s) will return an id
of either invalid_parameter
or bad_request
. The associated message will detail simple request errors such as
missing required fields or improperly formatted date parameters.
Authentication
The /authenticate
endpoint is POST method based, which will require username, password and the API key, to generate a token and an SSO (Single Sign On) key. That token will expire after 2 hours and will be needed to be generated again.
This token will be used when you hit the other API URL’s but the SSO key will never expire. All the communication will be done through tokens.
User can also communicate with rest of endpoints using SSO key, if he/she does not want to create token again and again.
The /saml/authenticate
endpoint is SAML based, which will require a username, password and the API key (as a query parameter). After login, it will generate a token and an SSO (Single Sign On) key. After that it will return generated response to your callback URL (that you will need to provide us before using this endpoint).
Example: https://yourCallbackURL?sso=xxxxxxxx
The advisor can then communicate with rest of endpoints using SSO key, if he/she does not want to create token again and again.
/authenticate
https://site.yourefolio.com/api/v1/authenticate
You will hit the ‘/authenticate’ api with POST request by using Postman
and set the following keys and values:
name: advisor_user_name (of Yourefolio)
password : xxxxxxxxx (of Yourefolio)
api_key : 123abc123abc123abc123abc123abc (provided by Yourefolio)
The endpoint /authenticate
will return token which is created by advisor’s username and password provided by POST method. It means that while making a request to this endpoint, advisor will need to provide correct username and password for Yourefolio account. That token will be unique for every advisor.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
{
"userId": "1244",
"token": "802723a4530560cdcba6196f814a962a",
"singleSignOn": "xxxxxxx",
"role": {
"roleId": "6",
"roleName": "paid_advisor"
},
"created": "2019-02-14 07:13:09 AM",
"expiresAt": "2019-02-14 09:13:09 AM"
}
Name | Type | Description |
---|---|---|
userId | integer | Advisor ID of current advisor. |
token | string | The token created for current logged in advisor. This token can be used for authentication for all upcoming API requests. |
singleSignOn | string | Unique key for each advisor that will never expire. |
role | Array key | Indicates that this array will contain values related to role |
roleId | string | Role id of the current advisor. |
roleName | string | Role name of the current advisor. |
created | string | Time of token creation. |
expiresAt | string | The expiry time of the token. |
/saml/authenticate
api/v1/saml/authentication?key=123abc123abc123abc123abc123abc&redirect_uri=callback_url
The endpoint /saml/authenticate
will return SSO key after login with username and password provided by advisor. It means that while making a request to this end-point, advisor will need to provide correct username and password for Yourefolio account. That SSO will be unique for each advisor and won’t expire.
After authorization, application will redirect with SSO as parameter:
www.yourapp.com/callback?sso=your_sso_id
/clients
https://site.yourefolio.com/api/v1/clients
Yourefolio's /clients end-point represents all the clients under current logged in advisor of Yourefolio. An advisor may have multiple clients. The client_id
you will get in this response is primary identifier for clients and will be used to obtain details for all upcoming end-points.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
{
{
"clientId": "1112",
"name": "John Doe",
"dateOfBirth": "11/11/1990",
"email": "testmail@yourefolio.com"
},
{
"clientId": "1124",
"name": "Riddle",
"dateOfBirth": "11/01/2001",
"email": "testmail2@yourefolio.com"
},
}
Name | Type | Description |
---|---|---|
clientId | integer | Unique identifier of client's account. This ID will be used to for upcoming detailed end-points. |
name | string | First and Last name of client. |
dateOfBirth | string | The date of birth of client. |
string | The email of client (always unique). |
/clients/{client_id}/personal_information
https://site.yourefolio.com/api/v1/clients/1124/personal_information
The endpoint /clients/{client_id}/personal_information
provides detailed information of a client.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
“firstName” : “Emission”,
“middleName” : “Ibsen”,
“lastName” : “Maple”,
“fullName” : “Emission Ibsen Maple Junior / Senior”,
“address” : “Test Address 123”,
“addressLine2” : “Test Address Line 2”,
“city” : “Washington DC”,
“dateOfBirth” : “09/09/1990”,
“gender” : “Male”,
“contact” : “(012) 345 6789”,
“zip” : “43345”,
“state” : “State of ABC”,
“county” : “Washington County”,
“spouseFirstName” : “Julie”,
“spouseMiddleName” : “Nina”,
“spouseLastName” : “Katherine”,
“spouseFullName” : “Julie Nina Katherine Junior / Senior”
“spouseDateOfBirth” : “01/01/1991”,
“spouseGender” : “Female”,
“spouseContact” : “(022) 235 6231”,
“spouseAddress” : “Test Address 456”,
“spouseAddressLine2” : “Test Spouse address Line 2”,
“spouseCity” : “New York”,
“spouseCounty” : “Doublin”,
“spouseState” : “New York”,
“spouseZip” : “43534-2348”,
“profilePicture” : “Path of profile picture”
}
]
Name | Type | Description |
---|---|---|
firstName | string | Client's first name. |
middleName | string | Client's middle name. |
lastName | string | Client's last name. |
fullName | string | Client's full name. |
address | string | Client's address line 1. |
addressLine2 | string | Client's address line 2. |
city | string | City of client |
dateOfBirth | string | Client's date of birth. |
gender | string | Client's gender. |
contact | string | Client's contact number. |
county | string | County name of client. |
zip | string | Client's zip code. |
state | string | Client's state. |
spouseFirstName | string | Client's spouse's first name (empty if name not provided). |
spouseMiddleName | string | Client's spouse's middle name (empty if name not provided). |
spouseLastName | string | Client's spouse's last name (empty if name not provided). |
spouseFullName | string | Client's spouse's full name. |
spouseDateOfBirth | string | Client's spouse's date of birth. |
spouseGender | string | Client's spouse's gender. |
spouseContact | string | Contact number of Spouse. |
spouseAddress | string | Spouse Address line 1. |
spouseAddressLine2 | string | Spouse Address Line 2. |
spouseCity | string | City name of Spouse. |
spouseCounty | string | County name of Spouse. |
spouseState | string | State name of Spouse. |
spouseZip | string | Zip Code of Spouse. |
profilePicture | string | Path of Client's profile picture. This value would be empty if profile picture is not uploaded. |
/clients/{client_id}/authorized_user
https://site.yourefolio.com/api/v1/clients/1124/authorized_user
The endpoint /clients/{client_id}/authorized_user
provides details of authorized users of a client.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
“firstName” : “Authorized”,
“middleName” : “User”,
“lastName” : “Name”,
"fullName" : “Authorized User Name Example 2”,
“contact” : “(009) 912 3456”,
“email” : “abc2@example.com”,
“relationToAccountHolder” : “Insurance Provider”,
“address” : “Test Address 123”,
“addressLine2” : “Test Address Line 2”,
“city” : “Washington DC”,
“state” : “State of ABC”,
“zip” : “12345”,
“gender” : “Male”,
“fid”: 1726
},
{
“firstName” : “Authorized”,
“middleName” : “User”,
“lastName” : “Name”,
"fullName" : “Authorized User Name Example”,
“contact” : “(009) 912 3456”,
“email” : “abc@example.com”,
“relationToAccountHolder” : “Insurance Provider”,
“address” : “Test Address 123”,
“addressLine2” : “Test Address Line 2”,
“city” : “Washington DC”,
“state” : “State of ABC”,
“zip” : “12345”,
“gender” : “Male”,
“fid”: 1727
}
]
Name | Type | Description |
---|---|---|
firstName | string | Authorized user's first name. |
middleName | string | Authorized user's middle name. |
lastName | string | Authorized user's last name. |
fullName | string | Authorized user's full name. |
contact | string | Authorized user's contact number. |
string | Authorized user's email address. | |
relationToAccountHolder | string | Authorized user's relationship with current client, indicating professional credibility of authorized user. |
address | string | Authorized user's address line 1. |
addressLine2 | string | Authorized user's address line 2. |
city | string | City of Authorized user. |
state | string | Authorized user's state. |
zip | string | Authorized user's zip code. |
gender | string | Authorized user's gender. |
fid | integer | Unique identifier for this record. |
/clients/{client_id}/financial_assets
https://site.yourefolio.com/api/v1/clients/1124/financial_assets
The endpoint /clients/{client_id}/financial_assets
provides details of financial assets of a client.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
"bankAccount": {
"value":"120000",
"accountTitle":"Account 1 owner",
"bankName":"Bank account 1",
"hasEstateTax": true,
"fid": 8004,
}
},
{
"bankAccount": {
"value":"19871100",
"accountTitle":"Account owner 2",
"bankName":"Bank account 2",
"hasEstateTax": false,
"fid": 8005
}
},
{
"investmentAccount": {
"accountType":"Investment type 1",
"institutionName":"First investment account name",
"accountNumber":"78978787KAB-7889",
"value":"789789",
"accountTitle":"Account owner name detail",
"hasEstateTax": true,
"fid": 8006
}
},
{
"investmentAccount": {
"accountType":"Investment account 2 types",
"institutionName":"Name of second investment account",
"accountNumber":"8789723897",
"value":"8789765400",
"title":"Second investment account owner",
"hasEstateTax": false,
"fid": 8007
}
},
{
"home": {
"value":"100000",
"mortgageHolder":"First home mortgage holder",
"mortgageBalance":"7897900",
"address":"Address of home 1",
"hasEstateTax": false,
"fid": 8008
}
},
{
"otherProperties": {
"value":"1000",
"mortgageHolder":"Other property 1 mortgage holder",
"mortgageBalance":"100900",
"description":"Details of other property 1",
"address":"Address of other property 1",
"hasEstateTax": false,
"fid": 8010
},
{
"autos": {
"vehicleType":"Ferrari",
"mortgageHolder":"Ferrari loan holder",
"mortgageBalance":"1900",
"value":"200000",
"accountTitle":"Account owner name",
"hasEstateTax": false,
"fid": 8012
}
},
{
"jewelry": {
"value":"190000000",
"jewelryItems":"Blue Diamond",
"accountTitle":"Jack",
"hasEstateTax": false,
"fid": 8015
}
},
{
"collectibleCoins": {
"value":"108800",
"description":"Coins description 1",
"accountTitle":"Account owner name",
"hasEstateTax": false,
"fid": 8016
}
},
{
"paintings": {
"value":"10990000000",
"description":"Mona Liza",
"accountTitle":"Account owner name",
"hasEstateTax": false,
"fid": 8018
}
},
{
"cardCollections": {
"value":"10000",
"description":"Card collection 1",
"accountTitle":"Account owner name",
"hasEstateTax": false,
"fid": 8020
}
},
{
"otherValuables": {
"value":"20000",
"description":"Other valuables ",
"accountTitle":"Account owner name",
"hasEstateTax": false,
"fid": 8021
}
},
{
"worth_calculations": {
"netWorth": 20972342187.33,
"taxableNetWorth": 454564570702,
"federalTax": 22400000,
"federalTaxExemptionAmount": 24120000,
"federalTaxBaseTaxAmount": 345000,
"federalTaxMarginRate": 40,
"stateTax": 0,
"stateTaxExemptionAmount": 3000000,
"stateTaxBaseTaxAmount": 1355000,
"stateTaxMarginRate": 16,
"trustsNetWorth": 0,
"federalEstateTax": 181816525280.80002,
"stateEstateTax": 72729590312.32,
"hasStateTax": true,
}
}
]
Name | Type | Description |
---|---|---|
bankAccount | Array key | Indicates that this array will contain values related to bank accounts section. |
value | string | Amount of the bank account. |
accountTitle | string | Account owner full name. |
bankName | string | Full name of the bank. |
hasEstateTax | boolean | Is personal banking account taxable to estate. |
investmentAccount | Array key | Indicates that following array record belongs to investment/retirements accounts section. |
accountType | string | Type of account. |
institutionName | string | Full name of financial institution. |
accountNumber | string | Account number. |
value | string | Account's total amount. |
accountTitle | string | Account owner's full name. |
hasEstateTax | boolean | Is investment account taxable to estate. |
home | Array key | Indicates that this array will contain values related to home section. |
value | string | Approximate value of of home. |
mortgageHolder | string | Mortgage holder of the property. |
mortgageBalance | string | Approximate balance of mortgage. |
address | string | Full address of the home. |
hasEstateTax | boolean | Is home taxable to estate. |
otherProperties | Array key | Indicates that following array record belongs to other properties accounts section. |
value | string | Approximate value of the property. |
mortgageHolder | string | Mortgage holder of the property. |
mortgageBalance | string | Approximate balance of the mortgage. |
description | string | Description of the property. |
address | string | Address of the property. |
hasEstateTax | boolean | Is other property taxable to estate. |
autos | Array key | Indicates that this array will contain values related to autos. |
vehicleType | string | Type of the vehicle. |
mortgageHolder | string | Loan holder of the vehicle. |
mortgageBalance | string | Loan balance of the vehicle |
value | string | Approximate value of the vehicle. |
accountTitle | string | Account owner's full name. |
hasEstateTax | boolean | Is vehicle taxable to estate. |
jewelry | Array key | Indicates that following array record belongs to jewelry section. |
value | string | Approximate value of jewelry item. |
jewelryItems | string | Type of jewelry. |
accountTitle | string | Full name of account owner. |
hasEstateTax | boolean | Is jewelry taxable to estate. |
collectibleCoins | Array key | Indicates that following array record belongs to collectible coins section. |
value | string | Approximate value of coins collection. |
description | string | Description of coins collection. |
accountTitle | string | Full name of account owner. |
hasEstateTax | boolean | Is coins taxable to estate. |
paintings | Array key | Indicates that following array record belongs to paintings section. |
value | string | Approximate value of painting. |
description | string | Description of painting. |
accountTitle | string | Full name of account owner. |
hasEstateTax | boolean | Is painting taxable to estate. |
cardCollections | Array key | Indicates that following array record belongs to card collection section. |
value | string | Approximate value of card collection. |
description | string | Description of card collection. |
accountTitle | string | Full name of account owner. |
hasEstateTax | boolean | Is card collection taxable to estate. |
otherValuables | Array key | Indicates that following array record belongs to other valuables section. |
value | string | Approximate value of valuable item. |
description | string | Description of the valuable. |
accountTitle | string | Full name of account owner. |
hasEstateTax | boolean | Is valueable taxable to estate. |
worth_calculations | Array key | Indicates that following array contains calculations of client's net worth (according to Yourefolio's formulas). |
netWorth | string | Total net worth of client. |
taxableNetWorth | string | Taxable net worth of client. |
federalTax | string | Applicable federal tax (only applies if client has spouse). |
federalTaxExemptionAmount | string | Federal tax exemption amount of client. |
federalTaxBaseTaxAmount | string | Federal base tax amount of client. |
federalTaxMarginRate | string | Federal tax margin rates of client. |
stateTax | string | Applicable state tax (varies w.r.t. different states). |
stateTaxExemptionAmount | string | Applicable state tax exemption amount. |
stateTaxBaseTaxAmount | string | Applicable state tax base tax amount. |
stateTaxMarginRate | string | Applicable state tax margin rates. |
trustsNetWorth | string | Total net worth of trusts of client. |
federalEstateTax | string | Federal estate tax of client. |
stateEstateTax | string | State estate tax of client. |
hasStateTax | string | Is applicable state tax. |
/clients/{client_id}/business_interests
https://site.yourefolio.com/api/v1/clients/1124/business_interests
The endpoint /clients/{client_id}/business_interests
provides details of business interests of a client.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
"name":"Business name",
"value":"102000",
"owner":"Business owner",
"hasEstateTax": true,
"fid": 8022,
},
{
"name":"Business name 2",
"value":"80000",
"owner":"Business owner 2",
"hasEstateTax": false,
"fid": 8023
}
]
Name | Type | Description |
---|---|---|
name | string | Name of the business |
value | string | Approximate worth of the business. |
owner | string | Full name of business owner. |
hasEstateTax | boolean | Is business taxable to estate. |
fid | integer | Unique identifier for this record. |
/clients/{client_id}/life_insurance
https://site.yourefolio.com/api/v1/clients/1124/life_insurance
The endpoint /clients/{client_id}/life_insurance
provides details of life insurance of a client.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
“type” : “Insurance Type”,
“deathBenefit” : “25000”,
“value” : “2022200”
“owner” : “Owner of Account”,
“annualIncome” : “1000000”,
"hasEstateTax": true,
“fid”: 1726,
},
{
“type” : “Insurance Type 2”,
“deathBenefit” : “201200”,
“value” : “10000"”
“owner” : “Owner of Account”,
“annualIncome” : “2000000”,
"hasEstateTax": false,
“fid”: 1730,
}
]
Name | Type | Description |
---|---|---|
type | string | Type of insurance. |
deathBenefit | string | Death benefit associated with the policy. |
value | string | Cash value of the policy. |
owner | string | Full name of life insurance owner. |
annualIncome | string | Annual income of the client from all sources. |
hasEstateTax | boolean | Is life insurance taxable to estate. |
fid | integer | Unique identifier for this record. |
/clients/{client_id}/pension_survivor_benefits
https://site.yourefolio.com/api/v1/clients/1124/pension_survivor_benefits
The endpoint /clients/{client_id}/pension_survivor_benefits
provides details of pensions and survivor benefits of a client.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
"pensionBenefits": {
"hasSurvivorBenefit": "TRUE",
"type": "Pension type 1",
"pensionProvider": "Pension provider",
"address": "Address of attorney",
"amount": "100000",
"owner": "Pension Account owner",
"accountTitle": "2 - Owned jointly with spouse (joint with rights of survivorship)",
"hasEstateTax": true,
"fid": 8023
}
},
{
"survivorBenefits": {
"location": "Location of survivor 1",
"value": "20000",
"owner": "Jack Samuel",
"accountTitle": "4 - Owned by account holders trust",
"description": "This is description of survivor benefit",
"hasEstateTax": false,
"fid": 8024
}
}
]
Name | Type | Description |
---|---|---|
pensionBenefits | Array key | Indicates that this array will contain values related to pension section. |
hasSurvivorBenefit | boolean | Do you have pension account? |
type | string | Type of pension benefit. |
pensionProvider | string | Name of pension carrier. |
address | string | Address of the carrier company. |
amount | string | What is the transferable amount associated with that pension. |
owner | string | Owner of the pension account. |
accountTitle | string | Title of the trust document. |
hasEstateTax | boolean | Is pension account taxable to estate. |
survivorBenefits | Array key | Indicates that this array will contain values related to survivor benefit section. |
location | string | Location of the survivor benefit. |
value | string | Value of the survivor benefit account. |
owner | string | Name of owner of survivor benefit account. |
accountTitle | string | Title of the suvivor benefit document. |
description | string | Description of the suvivor benefit. |
hasEstateTax | boolean | Is survivor taxable to estate. |
fid | integer | Unique identifier for this record. |
/clients/{client_id}/beneficiary
https://site.yourefolio.com/api/v1/clients/1124/beneficiary
The endpoint /clients/{client_id}/beneficiary
provides details of beneficiaries of a client.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
"firstName":"John",
"middleName" : “Samuel”,
"lastName" : "Doe",
"fullName:"John Samuel Doe Senior",
"dateOfBirth":"09/09/1990",
"contact":"(123) 123-1231",
"email":"test@texample.com",
"relation":"Beneficiary",
"address":"47000 Warm Springs Blvd",
"addressLine2":"#418",
"city":"Fremont",
"state":null,
"zip":"94539",
"beneficiaryRelationship":"Father",
"hasOtherSelectedRelationship": true,
"gender":"male",
"beneficiaryStatus":"From marriage",
"beneficiaryStatusOther":"Other",
"fid": 1218
},
{
"firstName":"Mark",
"middleName" : "Wayne",
"lastName" : “Downy”,
"fullName":"Mark Wayne Downy",
"dateOfBirth":"11/11/1991",
"contact":"(098) 765-4321",
"email":"benef@benef.com",
"relation":"Both",
"address":"53 Lafayette Rd",
"addressLine2":"Somewhere else",
"city":"Everywhere",
"state":Kentucky,
"zip":"12345-6789",
"beneficiaryRelationship":null,
"hasOtherSelectedRelationship": fakse,
"gender":"male",
"beneficiaryStatus":"From another marriage or relationship",
"beneficiaryStatusOther":null,
"fid": 1219
}
]
Name | Type | Description |
---|---|---|
firstName | string | Beneficiary's first name. |
middleName | string | Beneficiary's middle name. |
lastName | string | Beneficiary's last name. |
suffix | string | Beneficiary's name suffix. |
fullName | string | Beneficiary's full name. |
dateOfBirth | string | Beneficiary's date of birth. |
contact | string | Beneficiary's contact number. |
string | Beneficiary's email address. | |
relation | string | Beneficiary's relationship with current client. |
address | string | Beneficiary's address line 1. |
addressLine2 | string | Beneficiary's address line 2. |
city | string | City of Beneficiary. |
state | string | Beneficiary's state. |
zip | string | Beneficiary's zip code. |
beneficiaryRelationship | string | Beneficiary's relationship with client, like Father, Son, Son-in-law, daughter etc. |
hasOtherSelectedRelationship | boolean | Is other type selected in beneficiary relationship? |
gender | string | Beneficiary's gender. |
beneficiaryStatus | string | Beneficiary's status. |
beneficiaryStatusOther | string | Beneficiary's other status. |
fid | integer | Unique identifier for this record. |
/clients/{client_id}/long_term_care_insurance
https://site.yourefolio.com/api/v1/clients/1124/long_term_care_insurance
The endpoint /clients/{client_id}/long_term_care_insurance
provides details of long term care insurance of a client.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
"hasLongTermCare": true,
"cashLimit": 2000.10,
"value": 25000,
"fid": 802
},
{
"hasLongTermCare": true,
"cashLimit": 3000,
"value": 35000.64,
"fid": 805
}
]
Name | Type | Description |
---|---|---|
hasLongTermCare | boolean | Do you have long term care insurance? |
cashLimit | float | Maximum cash limit associated with respective insurance, on daily basis. |
value | float | Cash value of respective long term care insurance. |
fid | integer | Unique identifier for this record. |
/clients/{client_id}/legal
https://site.yourefolio.com/api/v1/clients/1124/legal
The endpoint /clients/{client_id}/legal
provides details of wills and trusts of a client.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
"wills": {
"accountTitle": "Will of client",
"description": "This contains will of John Doe",
"fid": 579
}
},
{
"trusts": {
"accountTitle": "Trust of client",
"description": "This contains trust details of John Doe",
"assignedAssets": null,
"netWorth": null,
"fid": 5792
}
},
{
"trustedAgents": {
"fullName": "Trusted agent name",
"contact": "Trusted agent phone number",
"address": Trusted agent address,
"roles": Trusted agent role,
"fid": 5792
}
}
]
Name | Type | Description |
---|---|---|
wills | Array key | This indicates that value inside this array will belong to Wills type section of the client. |
accountTitle | string | Title of Will document. |
description | string | Details of the Will document |
trusts | Array key | This indicates that value inside this array will belong to Trust section of the client. |
accountTitle | string | Title of Trust document. |
description | string | Details of the Trust document |
assignedAssets | string | Assigned assets of the Trust document |
netWorth | string | Total net worth of the Trust document |
fid | integer | Unique identifier for this record. |
trustedAgents | Array key | This indicates that value inside this array will belong to Trust section of the client. |
fullName | string | Trusted agent name of the client. |
contact | string | Trusted agent phone number of the client. |
address | string | Trusted agent address of the client. |
roles | string | Trusted agent role of the client. |
fid | integer | Unique identifier for this record. |
/clients/{client_id}/general
https://site.yourefolio.com/api/v1/clients/1124/general
The endpoint /clients/{client_id}/general
is a generic end-point that will return results of following API end-points, in single generic multi-dimensional array:
- /personal_information
- /authorized_user
- /financial_assets
- /business_interests
- /life_insurance
- /pension_survivor_benefits
- /beneficiary
- /long_term_care_insurance
- /legal
- /notes (GET)
- /advisor
- /advisor/details
/clients/{client_id}/notes
https://site.yourefolio.com/api/v1/clients/1124/notes
The endpoint /clients/{client_id}/notes
can be used to fetch and add notes in the Client Relationship Manager (CRM) in Yourefolio system by using the GET
method (for fetching) and POST
method (for adding) with your authentication token or SSO key.
POST:
To add notes in Yourefolio system, you will create a JSON POST request to add notes in CRM with key notes
. You will need to provide the note title, note description, note action, and date values.
For sampel request body, look at right panel under heading Sample Body Data (POST).
{
"notes": [
{
"note_title": "note title one",
"note_notes": "note desc",
"note_action": "email",
"date": "12/12/2019"
},
{
"note_title": "note title two",
"note_notes": "note desc",
"note_action": "reminder",
"date": "12/12/2019"
},
{
"note_title": "note title 3",
"note_notes": "note desc",
"note_action": "email",
"date": "12/12/2022"
}
]
}
GET:
To fetch notes from Yourefolio system, you will make a GET request.
For sampel request response, look at right panel under heading Response Body (GET).
{
{
"title": "note title one",
"note": "note desc",
"action": "email",
"date": "12/12/2019"
},
{
"title": "note title two",
"note_": "note desc",
"action": "reminder",
"date": "12/12/2019"
},
{
"title": "note title 3",
"note": "note desc",
"action": "email",
"date": "12/12/2022"
}
}
Name | Type | Description |
---|---|---|
title | string | Full title of the note. |
note | string | Detailed description of the note. |
action | string | Action type of the note. This can be Call, Meeting, Email, Video Conference or Other. |
date | string | Date for the note. |
/clients/{client_id}/hippa
https://site.yourefolio.com/api/v1/clients/1124/hippa
The endpoint /clients/{client_id}/hippa
provides Hippa information of the client by his ID.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
“healthCareProvider” : “National Health Service”,
“groupNumber” : “192”,
“identificationNumber” : “633”,
“medicalCondition” : “any medical condition”,
“serviceNumber” : “869”,
“contact” : “(901) 119-3082”,
“address” : “H # 30, 54 Harward Street”,
“coverageType” : “Coverage Type of Hippa”,
“fid” : 15097,
}
]
Name | Type | Description |
---|---|---|
healthCareProvider | string | Current health care provider of client. |
groupNumber | string | Group number of hippa of client. |
identificationNumber | string | Identification number of hippa of client. |
medicalCondition | string | Medical condition of client. |
serviceNumber | string | Service number of hippa of client. |
contact | string | Phone number of client. |
address | string | Complete address of client. |
coverageType | string | Type of supplemental coverage of hippa of client. |
fid | integer | Unique identifier of record. |
/clients/{client_id}/miscellaneous
https://site.yourefolio.com/api/v1/clients/1124/miscellaneous
The endpoint /clients/{client_id}/miscellaneous
provides miscellaneous information of the client by his ID.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
“name” : “Name of pet”,
“type” : “Type of pet”,
“details” : “Details of pet”,
“fid” : 15175,
}
]
Name | Type | Description |
---|---|---|
name | string | Name of pet of client. |
type | string | Type of pet of client. |
details | string | Details of pet of client. |
fid | integer | Unique identifier of record. |
/clients/get-taxes
https://site.yourefolio.com/api/v1/clients/get-taxes
The endpoint /clients/get-taxes
provides all taxes of the client by his ID and networth.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
{
"worth_calculations": {
"netWorth":454564572030,
"federalTax":181816180812,
"stateTax":72729851524.8,
"federalEstateTax": 181816525812,
"stateEstateTax": 72729590524.8,
"hasStateTax": true
}
}
Name | Type | Description |
---|---|---|
worth_calculations | Object key | Indicates that this object will contain values related to net worth calculations. |
netWorth | string | Total net worth of client. |
federalTax | string | Applicable federal tax of client. |
stateTax | string | Applicable state tax of client. |
federalEstateTax | integer | Federal estate tax of client. |
stateEstateTax | integer | State estate tax of client. |
hasStateTax | boolean | Is applicable for state tax. |
/clients/{client_id}/advisor
https://site.yourefolio.com/api/v1/clients/1124/advisor
The endpoint /clients/{client_id}/advisor
provides concise information of the advisor of a client.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
“advisorName” : “John Doe”,
“advisorEmail” : “john.doe@yourefolio.com”,
“advisorPhoneNumber” : “(219) 306-2358”,
“advisorAddress” : “178 Cleveland Rd, Street 9”,
“advisorAddressLine2” : “Ohio, UK”,
“advisorCity” : “Cleveland”,
“advisorState” : “Maryland”,
“advisorZipCode” : “44130”,
“advisorCounty” : “Washington County”,
}
]
Name | Type | Description |
---|---|---|
advisorName | string | Full name of advisor. |
advisorEmail | string | Email of advisor. |
advisorPhoneNumber | string | Phone number of advisor. |
advisorAddress | string | Street address of advisor. This contains 1st street address. |
advisorAddressLine2 | string | Street address of advisor. This contains 2nd street address. |
advisorCity | string | City of advisor. |
advisorState | string | State of advisor. |
advisorZipCode | string | Zip code of advisor. |
advisorCounty | string | County name of advisor. |
/advisor/{advisor_id}/details
https://site.yourefolio.com/api/v1/advisor/1910/details
The endpoint /advisor/{advisor_id}/details
provides detailed information of the advisor by his ID.
Response Fields
If request is successful, you will get response shown in right column, under Response Body heading.
[
{
“firstName” : “George”,
“middleName” : “M.”,
“lastName” : “Angler”,
“advisorName” : “George M. Angler”,
“advisorEmail” : “georgem@yourefolio.com”,
“advisorPhoneNumber” : “(901) 119-3082”,
“advisorAddress” : “H # 30, 54 Harward Street”,
“advisorAddressLine2” : “Ohio UK”,
“advisorCity” : “New York”,
“advisorState” : “New York”,
“advisorZipCode” : “44130”,
“advisorCounty” : “Washington County”,
“title” :
[
“Registered Representative”,
“Financial Advisor”
],
“crdNumber” : “186e3”,
“cfpNumber” : “x9873kj”,
“attorneyNumber” : “234809”,
“stateInsuranceLicenseNumber” : “348230984”,
“otherNumber” : 908923849,
}
]
Name | Type | Description |
---|---|---|
firstName | string | First name of advisor. |
middleName | string | Middle name of advisor. |
lastName | string | Last name of advisor. |
advisorName | string | Full name of advisor. |
advisorEmail | string | Email of advisor. |
advisorPhoneNumber | string | Phone number of advisor. |
advisorAddress | string | Street address of advisor. This contains 1st street address. |
advisorAddressLine2 | string | Street address of advisor. This contains 2nd street address. |
advisorCity | string | City of advisor. |
advisorState | string | State of advisor. |
advisorZipCode | string | Zip code of advisor. |
advisorCounty | string | County name of advisor. |
title | array | An array of titles of advisor. |
crdNumber | string | CRD number of advisor. |
cfpNumber | string | CFP number of advisor. |
attorneyNumber | string | Attorney number of advisor. |
stateInsuranceLicenseNumber | string | State insurance license number of advisor. |
otherNumber | string | Other number of advisor. |