The goal of the LifeDX is to create industry standards around how data is transferred between carriers and partners. You can think of it as a universal translation tool for carrier data. It was developed to move data dissemination from traditional spreadsheet/CSV files to streamlined APIs to improve security, reduce testing time, and open the door to innovation within this industry.
\nThe API is organized around REST. It strives to standardize differing carrier information into common objects and data structures. Versioning is enforced through API endpoint urls. We recommend that all API calls be made over https.
\nTo obtain a Partner Token you will need to create a Partner account. You can obtain a vendor account from any of the carriers on the LifeDX, or you can contact us at sales@thelifedx.com. Your Partner Token will be provided after your Partner account is created. Your Partner Token should never be shared or visible to the public. If you have questions or problems with obtaining or using your Vendor Token, you can email us at support@thelifedx.com.
\nIn order to access any carrier specific information through the LifeDX, you will need to obtain permissions from individual carriers. Each endpoint will require you to send one or more Carrier Tokens with it. Carrier Tokens are unique identifiers of your relationship with a carrier. Your Carrier Tokens should never be shared or visible to the public. To obtain these tokens you will need to contact carriers directly and request to become a Partner with them through the LifeDX.
\nThe LifeDX offers a variety of endpoints for interacting with carrier data. If you have any questions about the API, please email support@thelifedx.com.
\n\n\nNOTE: If your app is not only requesting public read-only information, then you may skip this step.
\n
The LifeDX API uses API tokens for authentication. Each Partner account has a Partner Token that will provide general access to the LifeDX API.
\nAccess to carrier information is controlled by the individual carriers through secure Carrier Tokens.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Getting Started","slug":"getting-started"},{"content":"Authentication","slug":"authentication"}],"owner":"5807659","collectionId":"61da7f72-1e47-4930-bb1e-c735f054e223","publishedId":"TVev55aQ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"172027","highlight":"0497FF"},"publishDate":"2021-04-05T19:09:39.000Z"},"item":[{"name":"Carriers","item":[{"name":"/v1/carriers","id":"6cf325fe-ca83-45bc-a2ea-222d1fd76a67","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"VENDOR-TOKEN"},{"key":"value","value":"{{partner_token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"url":"https://api.thelifedx.com/v1/carriers","description":"This will return all the carriers that the requesting vendor has access to. This is an easy way for a vendor to access their carrier tokens, which are required with other endpoints.
\n","urlObject":{"path":["v1","carriers"],"host":["https://api.thelifedx.com"],"query":[],"variable":[]}},"response":[{"id":"0e641fbf-fefd-40fc-8429-4b74c9fca14d","name":"400 Bad Request","originalRequest":{"method":"GET","header":[],"url":"https://api.thelifedx.com/v1/carriers"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 23 Nov 2020 00:15:27 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx/1.17.10"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"Cache-Control","value":"no-cache"},{"key":"X-Request-Id","value":"057a6e6e-39ff-48bf-8b58-7ab37e0cf52d"},{"key":"X-Runtime","value":"0.035885"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"errors\": [\n {\n \"type\": \"not_authorized\",\n \"param\": \"VENDOR-TOKEN\",\n \"message\": \"You do not have permission to access this endpoint.\"\n }\n ]\n}"},{"id":"a98bdaaa-37f2-42c0-8d4d-404534830f43","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"VENDOR-TOKEN","value":"{{partner_token}}","type":"text"}],"url":"https://api.thelifedx.com/v1/carriers"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 23 Nov 2020 00:14:23 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"nginx/1.17.10"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Vary","value":"Origin"},{"key":"ETag","value":"W/\"b6d6e59e456fd6a780a27287beb90e93\""},{"key":"Cache-Control","value":"max-age=0, private, must-revalidate"},{"key":"X-Request-Id","value":"9acf69ae-7281-40f6-a328-9dbd4cf0e998"},{"key":"X-Runtime","value":"0.423543"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"name\": \"REQUIRED
An array of Carrier Token strings
REQUIRED
An array of product id integers from the /v1/carriers endpoint. Product IDs not associated with the provided Carrier Tokens will be ignored.
REQUIRED
An array of strings. Allowed values are: Standard, Standard Plus, Preferred, Preferred Plus, Table A, Table B, Table C, Table D, Table E, Table F, Table G, Table H, Table I, Table J, Table K, Table L, Table M, Table N, Table O, Table P
REQUIRED
An integer representing the desired face amount.
REQUIRED
Any valid two character state abbreviation.
REQUIRED
One of these values: Male, Female
REQUIRED
A valid date in the past. Must follow the format YYYY-MM-DD
OPTIONAL
Set to true if the proposed insured is a tobacco user
OPTIONAL
Set to true to quote with an accidental death benefit rider
OPTIONAL
Set to tru to quote with a waiver of premium rider
OPTIONAL
A valid positive integer indicating the number of child rider units to include with the quotes
OPTIONAL
A valid integer or float
(Required)
\n","type":"text/plain"},"type":"string","value":"test","key":"id"}]}},"response":[{"id":"78832403-f17d-4a7a-ace1-66f132322632","name":"200 OK","originalRequest":{"method":"GET","header":[{"description":{"content":"Added as a part of security scheme: apikey","type":"text/plain"},"key":"VENDOR-TOKEN","value":"REQUIRED
An array of Carrier Token strings
OPTIONAL
Any valid two character state abbreviation.
OPTIONAL
A valid product group id integer from /v1/carriers
OPTIONAL
An array of valid form tag ids from /v1/form_tags
OPTIONAL
A string to search against form names and numbers
(Required)
\n","type":"text/plain"},"type":"string","value":"Embeddable E-Tickets can be embedded anywhere that runs html, css, and javascript.
\n<link href=\"https://embed.thelifedx.com/eticket/css/reset.css\" rel=\"stylesheet\" type=\"text/css\"> \n<script type=\"text/javascript\">\n window.LIFEDX_ETICKET = {\n token: 'TOKEN_PROVIDER_BY_CARRIER'\n };\n</script> \n<div id=\"lifedx_eticket_form\"></div> \n<script type=\"text/javascript\" src=\"https://embed.thelifedx.com/eticket/js/eticket.widget.js\"></script>\nWe allow you to theme some of the UI for the embeddable e-tickets. However, in order to maintain a carrier approved user experience, you are limited to the following:
\nTo define these, simply pass them into the LIFEDX_ETICKET object. The default values are displayed below:
\n<script type=\"text/javascript\">\n window.LIFEDX_ETICKET = {\n token: 'TOKEN_PROVIDER_BY_CARRIER',\n theme: {\n border_radius: 4,\n input_padding: 10,\n FontFamilies: {\n DEFAULT: \"'Roboto', Helvetica, Arial, sans-serif\"\n },\n FontSizes: {\n XSMALL: 10,\n SMALL: 12,\n REGULAR: 13,\n MEDIUM: 14,\n LARGE: 16,\n XLARGE: 20,\n XXLARGE: 30\n },\n FontWeights: {\n REGULAR: 400,\n MEDIUM: 500,\n BOLD: 700\n },\n Colors: {\n MAIN: '#52ADFF',\n GREEN: '#1DBC3E',\n RED: '#DF4B4B'\n }\n }\n };\n</script>\nEach e-ticket requires a valid quote. There are two ways to provide a quote. The first and preferred way is to provide a valid LifeDX quote id generated by the LifeDX Life Quotes API. Speak to your carrier contact to learn how to gain access to the LifeDX Life Quotes API. Once you have a valid quote id, you can pass it into the LIFEDX_ETICKET object. An example is below:
\n<script type=\"text/javascript\">\n window.LIFEDX_ETICKET = {\n token: 'TOKEN_PROVIDER_BY_CARRIER',\n quote_id: 'LIFEDX_LIFE_QUOTE_ID'\n };\n</script>\n<script type=\"text/javascript\">\n window.LIFEDX_ETICKET = {\n token: 'TOKEN_PROVIDER_BY_CARRIER',\n quote_data: {\n product_id: 1, // a valid LifeDX product id\n state: 'UT', // a valid US state two character abbreviation\n face_amount: 250000, // a number greater than 0\n gender: 'Male', // 'Male', 'Female'\n health_class: 'Standard', // 'Standard', 'Standard Plus', 'Preferred', 'Preferred Plus', 'Table A', 'Table B', 'Table C', 'Table D', 'Table E', 'Table F', 'Table G', 'Table H', 'Table I', 'Table J', 'Table K', 'Table L', 'Table M', 'Table N', 'Table O', 'Table P'\n date_of_birth: '1985-02-25', // YYYY-MM-DD\n tobacco: false, // boolean\n adb_rider: false, // boolean\n wop_rider: false, // boolean\n child_rider_units: 0, // number\n }\n };\n</script>\nIn many cases you will already have some of the information needed to complete a carrier's e-ticket. You can pre-fill that data by passing an array of objects into the LIFEDX_ETICKET object under the form_data attribute. Each object should contain a name and a value attribute. An example is below:
<script type=\"text/javascript\">\n window.LIFEDX_ETICKET = {\n token: 'TOKEN_PROVIDER_BY_CARRIER',\n form_data: [\n { name: 'pi_first_name', value: 'John' },\n { name: 'pi_last_name', value: 'Smith' }\n ]\n };\n</script>\n