Results

After a user completes an assessment, you'll be able to retrieve their data for your own use, as well as select what details will be shown to the user. These results include Personality Types & Blends, Personality Traits, and the corresponding badge for each personality type.

Get

This method allows you to get all the results of a completed assessment in one resource, if the assessment hasn't been completed, the assessment slides will be returned. This endpoint takes a param that will let you choose what data is returned to you. It also allows you to specify with image_pack of the icons that are returned.

Resource Information

HTTP Method GET
Resource URL https://api.traitify.com/v1developer/assessments/{assessment_id}
Authentication Required? Yes
Response Format JSON

Query Parameters

data
optional
This is a comma seperated list of the data that you would like returned for an assessment. The default is just to return the assessment data if the assessment is complete. If the assessment is not complete, slides will be returned by default.
Example values: blend,types,traits,career_matches; blend; blend,traits; blend,career_matches; types,traits
image_pack
optional
This is the image pack you want to use for the personality type icons that are returned.
Example values: flat,linear

Example Request

GET
Authorization: Basic {your_public_key}:x
https://api.traitify.com/v1/assessments/{assessment_id}?data=blend,types,traits,career_matches

Example Response

200 OK

{
    "id": "7c3f284b-a4f3-408c-83b6-e6ba5f8f9d88",
    "deck_id": "career-deck",
    "completed_at": 1414091517133,
    "created_at": 1414091516266,
    "personality_blend": {
        "personality_type_1": {
            "id": "55071620-bca6-4f15-b466-de8733a834a8",
            "name": "Visionary",
            "description": "'Visionaries'...are pioneers.  They are great convincers and like to work with others in a 'take charge' capacity.  They love to take risks, make changes and set trends.  They tend to be   ambitious and energetic.  Visionaries are often in positions of prominence in business and the public eye and excel at taking charge and gaining the confidence of others.",
            "badge": {
                "image_small": "https://traitify-api.s3.amazonaws.com/badges/visionary/linear/small",
                "image_medium": "https://traitify-api.s3.amazonaws.com/badges/visionary/linear/medium",
                "image_large": "https://traitify-api.s3.amazonaws.com/badges/visionary/linear/large",
                "font_color": "",
                "color_1": "b857e5",
                "color_2": "",
                "color_3": ""
            },
            "keywords": "leading, managing, selling, trend-setting, persuading, competing, moving forward, extroversion",
            "details": [],
            "environments": [],
            "famous_people": []
        },
        "personality_type_2": {
            "id": "5f36d2be-d06f-4f11-9450-e749e5fc19d6",
            "name": "Analyzer",
            "description": "'Analyzers'...are inquisitive.  They delve, study and look deeply for information.  They have a keen eye and an experimental nature.  Analyzers use these capacities to figure out problems and search for the facts, often in a laboratory environment.  They excel at going beyond the surface toward uncovering information and discovery.",
            "badge": {
                "image_small": "https://traitify-api.s3.amazonaws.com/badges/analyzer/linear/small",
                "image_medium": "https://traitify-api.s3.amazonaws.com/badges/analyzer/linear/medium",
                "image_large": "https://traitify-api.s3.amazonaws.com/badges/analyzer/linear/large",
                "font_color": "",
                "color_1": "17AEE7",
                "color_2": "",
                "color_3": ""
            },
            "keywords": "investigating, solving, researching, delving, examining, discovering, introversion",
            "details": [],
            "environments": [],
            "famous_people": []
        },
        "name": "Visionary/Analyzer",
        "description": "You are drawn to others who share your interest and curiosity in the world.  A natural leader and full of ambition, you're often the one presenting the paper that others have come to hear.  Others look up to you and follow your lead. You are a deep thinker, and you enjoy learning new things.  You also always have a suggestion for something new that you want to check out or learn about, and your friends appreciate getting new ideas from you.  You are happiest when surrounded by other people, and you thrive when you are out in the world.  However, you also enjoy a quiet evening at home with several close friends, full of invigorating discussion and deep thinking.",
        "personality_group": null,
        "keywords": null,
        "details": [
            {
                "title": "Complement",
                "body": "You like to work with other Analyzers who share your intellectual interests.  You also appreciate working with your Planners because as the person who brings the 'big ideas,' you rely on your Planner colleagues to take care of and remember the details.  You and your Planner coworkers make the perfect team, working in tandem to cover all aspects of a project."
            },
            {
                "title": "Conflict",
                "body": "As a natural leader and a rational person, you are fortunate in that you work well with all types of colleagues.  However, you may find that if there are too many other Visionaries on your team, you get the feeling that there are 'too many cooks in the kitchen.'  This can be frustrating for you and those on your team as they may be confused about whom to follow.\r\nYou may also find that you have to adjust your leadership style for your Action-Taker colleagues.  You tend to think before you act, and your Action-Taker colleagues are just the opposite, sometimes making their work style difficult for you to understand."
            }
        ],
        "environments": [
            {
                "id": "cb2e44c8-dedf-4b4e-b51b-32c019fdc021",
                "name": "Offers clear opportunities for career advancement",
                "description": "",
                "personality_type": null,
                "active": true,
                "created_at": 1409256158085
            },
            ...
        ],
        "famous_people": []
    },
    "personality_types": [
        {
            "personality_type": {
                "id": "55071620-bca6-4f15-b466-de8733a834a8",
                "name": "Visionary",
                "description": "'Visionaries'...are pioneers.  They are great convincers and like to work with others in a 'take charge' capacity.  They love to take risks, make changes and set trends.  They tend to be   ambitious and energetic.  Visionaries are often in positions of prominence in business and the public eye and excel at taking charge and gaining the confidence of others.",
                "badge": {
                    "image_small": "https://traitify-api.s3.amazonaws.com/badges/visionary/linear/small",
                    "image_medium": "https://traitify-api.s3.amazonaws.com/badges/visionary/linear/medium",
                    "image_large": "https://traitify-api.s3.amazonaws.com/badges/visionary/linear/large",
                    "font_color": "",
                    "color_1": "b857e5",
                    "color_2": "",
                    "color_3": ""
                },
                "keywords": "leading, managing, selling, trend-setting, persuading, competing, moving forward, extroversion",
                "details": [],
                "environments": [
                    {
                        "id": "ba9440a8-6c86-4103-a898-eeb923eabdcd",
                        "name": "Offers leadership opportunities",
                        "description": "",
                        "personality_type": null
                    },
                    ...
                ],
                "famous_people": [
                    {
                        "id": "45fdec2c-b4d6-43ef-a015-76ee092064ac",
                        "name": "Barack Obama",
                        "description": "44th President of the United States",
                        "picture": "https://traitify-api.s3.amazonaws.com/famous_people/b599f229-578f-4627-959b-d477c3d3e10b.jpeg"
                    },
                    ...
                ]
            },
            "score": 61.49495
        },
        ...
    ],
    "personality_traits": [
        {
            "personality_trait": {
                "name": "Leader",
                "definition": "functions best when directing others",
                "description": "",
                "personality_type": {
                    "id": "55071620-bca6-4f15-b466-de8733a834a8",
                    "name": "Visionary",
                    "description": "'Visionaries'...are pioneers.  They are great convincers and like to work with others in a 'take charge' capacity.  They love to take risks, make changes and set trends.  They tend to be   ambitious and energetic.  Visionaries are often in positions of prominence in business and the public eye and excel at taking charge and gaining the confidence of others.",
                    "badge": {
                        "image_small": "https://traitify-api.s3.amazonaws.com/badges/visionary/linear/small",
                        "image_medium": "https://traitify-api.s3.amazonaws.com/badges/visionary/linear/medium",
                        "image_large": "https://traitify-api.s3.amazonaws.com/badges/visionary/linear/large",
                        "font_color": "",
                        "color_1": "b857e5",
                        "color_2": "",
                        "color_3": ""
                    },
                    "keywords": "leading, managing, selling, trend-setting, persuading, competing, moving forward, extroversion",
                    "details": [],
                    "environments": [
                        {
                            "id": "ba9440a8-6c86-4103-a898-eeb923eabdcd",
                            "name": "Offers leadership opportunities",
                            "description": "",
                            "personality_type": null
                        },
                        ...
                    ],
                    "famous_people": [
                        {
                            "id": "9f125b12-e0b0-478b-a1b9-05e0638a8c97",
                            "name": "George W. Bush",
                            "description": "43rd President of the United States",
                            "picture": "https://traitify-api.s3.amazonaws.com/famous_people/0943f7f0-a2ca-4641-a563-a18487885e08.jpeg"
                        },
                        ...
                    ]
                }
            },
            "score": 76.2712
        },
        ...
    ],
    "career_matches": [
        {
            "career": {
                "id": "25-1042.00",
                "title": "Biological Science Teachers, Postsecondary",
                "description": "Teach courses in biological sciences. Includes both teachers primarily engaged in teaching and those who do a combination of teaching and research.",
                "majors": [
                    {
                        "id": "26.0799",
                        "title": "Zoology/Animal Biology, Other.",
                        "description": "Any instructional program in zoology/animal biology not listed above.",
                        "group_id": "26"
                    },
                    ...
                ],
                "experience_level": {
                    "id": 5,
                    "name": "Extensive Preparation Needed",
                    "experience": "Extensive skill, knowledge, and experience are needed for these occupations. Many require more than five years of experience. For example, surgeons must complete four years of college and an additional five to seven years of specialized medical training to be able to do their job.",
                    "education": "Most of these occupations require graduate school. For example, they may require a master's degree, and some require a Ph.D., M.D., or J.D. (law degree).",
                    "job_training": "Employees may need some on-the-job training, but most of these occupations assume that the person will already have the required skills, knowledge, work-related experience, and/or training.",
                    "examples": "These occupations often involve coordinating, training, supervising, or managing the activities of others to accomplish goals. Very advanced communication and organizational skills are required. Examples include librarians, lawyers, sports medicine physicians, wildlife biologists, school psychologists, surgeons, treasurers, and controllers.",
                    "svp_range": "(8.0 and above)"
                },
                "salary_projection": {
                    "source": "Bureau Of Labor Statistics - May 2013",
                    "total_employees": 50230,
                    "hourly_rate_10_percentile": 0,
                    "hourly_rate_25_percentile": 0,
                    "hourly_rate_75_percentile": 0,
                    "hourly_rate_90_percentile": 0,
                    "hourly_rate_median": 0,
                    "hourly_rate_mean": 0,
                    "annual_salary_10_percentile": 40280,
                    "annual_salary_25_percentile": 54340,
                    "annual_salary_75_percentile": 107260,
                    "annual_salary_90_percentile": 149480,
                    "annual_salary_median": 75740,
                    "annual_salary_mean": 87080
                },
                "employment_projection": {
                    "source": "Bureau Of Labor Statistics - 2012",
                    "annual_salary_median_2012": 74180,
                    "total_employees_2012": 61400,
                    "total_employees_2022": 73400,
                    "new_openings_2022": 12000,
                    "new_openings_and_replacement_2022": 21200,
                    "percent_growth_2022": 19.5
                },
                "bright_outlooks": null
            },
            "score": 67.99428187375801
        },
        ...
    ]
}