Embrace Quote API FAQ

The Embrace Pet Insurance Quote API is a collection of endpoints that allows external partners to generate and update quotes and receive a range of coverage options based on the pets’ information and owner’s location, which they can then display for their users. Approved partners will have access to the API’s endpoints and be able to redirect users to the Embrace website in order to purchase a policy.  

Authorization

Each external partner will require a subscription key, provided by Embrace, to access the API’s endpoints. This subscription key must be passed in the http request headers. 

The header name is “epi-apim-subscription-key” and the value will be provided by Embrace. 

Example in Postman:

Contact Information

Please send an email to PartnerAPISupport@embracepetinsurance.com should you have issues accessing or using the API.

Terms of Use

Should any abuse of the Embrace API’s endpoints occur, your subscription will immediately be suspended. 

Do not share your subscription key outside of those who need to know it within your organization.  

Do not publish your key in publicly accessible code or repositories. 

Basics

The Embrace API is a collection of REST endpoints that must be called using HTTPS. 

To create an Embrace Quote, you simply need to call the quotes POST endpoint with all the required information provided, and in the response, you will receive a unique QuoteId, a Premium Summary of the defaulted Selected Coverage Option for the Pet(s), and a list of available Coverage Options for each Pet that can be chosen by the Pet Parent. Each Pet will have one (1) Preferred Coverage Option, which is the same as its defaulted Selected Option. The "quoteLinkUrl" of the chosen coverage will redirect the user to Embrace's Quote Engine where the selected coverage details will be loaded and the user can purchase a policy.

Environments

1. First integrate the Quote API with the test environment (url: https://api.embrace.dev/external-quote-test)

2. Integrate the API with the production environment once testing is complete (url: https://api.embrace.dev/external-quote)

Prerequisites

Subscriber Keys are provided by Embrace and can be accessed in the Profile section of this site. There are unique Subscriber Keys for each environment.

Each partner will only have one set of Subscriber Keys for each environment (Primary and Secondary). Embrace will make these available to the registered email address indicated by each partner. We recommend using a shared developer email/account for this rather than an individual developer's.

Tools

For initial understanding of the API beyond the documentation provided, we recommend using Postman to test each endpoint with various values for the required data. 

Troubleshooting

Before you contact us: 

Have you added your subscription key to the header? 

Is your data in the correct format and does it include all required fields? 

Have any copy/paste issues occurred? 

Here is a list of http statuses for reference for help debugging. Postman, or other similar tools, can be helpful in understanding these.

Potential Errors

(Errors that could occur and are not simple request object validation errors) 

Existing Policyholder – Occurs when a policy already exists with provided Contact Email

Breed Not Found – Occurs when a Breed Id passed to the API is not valid

Pet Under 6 Weeks or over 20 years of Age - Pets cannot be quoted if under 6 weeks or over 20 years of age

Address Is Not Valid - Occurs when an address is entered incorrectly by the user (exs: street number is out of range, zip code does not exist...)