Yasmina AI Official Documentation

Learn how to integrate Yasmina embedded insurance smoothly into your platform.

Quick linksAuthenticate API Sign up Changelog

Sandbox Test API Keys

Client ID

9f757acd-1ab4-466f-8cb2-d65ddedb2374

Client Secret

tQraH8lXWnU5uZmnIrHazAyf8of0Jm3vYlh7Nyzo

Try out Motor Insurance on Sandbox

Authenticate

You can exchange your API Keys with an Access token. This access token will then be used to access all our APIs

curl -X POST https://sandbox.yasmina.ai/oauth/token \
  -u "9f757acd-1ab4-466f-8cb2-d65ddedb2374:tQraH8lXWnU5uZmnIrHazAyf8of0Jm3vYlh7Nyzo" \
  -d "grant_type=client_credentials"

If tokens expire, you need to regenerate a new one using this API.

Request a quote OTP

curl --location 'https://sandbox.yasmina.ai/api/v1/car-comp/quote-otp' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer $ACCESS_TOKEN' \
  --data-raw '{
    "email": "[email protected]",
    "phone": "0533XXXXXX",
    "owner_id": "10XXXXXXXX"
}'

This endpoint sends an OTP to the provided phone number.

Request multi-provider quotes

curl --location 'https://sandbox.yasmina.ai/api/v1/car-comp/quote-requests' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer $ACCESS_TOKEN' \
  --data-raw '{
    "otp": "2578",
    "email": "[email protected]",
    "owner_id": "10XXXXXXXX",
    "phone": "0533XXXXXX",
    "birthdate": "1989-02-17",
    "car_sequence_number": 812309654,
    "is_ownership_transfer": true,
    "current_car_owner_id": "7012XXXXXX",
    "car_estimated_cost": 52000,
    "car_model_year": 2023
}'

Use the OTP and customer data from the previous step to retrieve prices from multiple insurers.

Request a policy issue OTP

curl --location 'https://sandbox.yasmina.ai/api/v1/car-comp/issue-otp' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer $ACCESS_TOKEN' \
  --data-raw '{
    "email": "[email protected]",
    "phone": "0533XXXXXX",
    "owner_id": "10XXXXXXXX",
    "quote_request_id": 64,
    "quote_reference_id": "6237e1aa-cec2-440e-acb5-20bcb8e99750",
    "quote_price_id": "3adc577e-4dc4-f011-972d-005056a9891a"
}'

Trigger an OTP confirmation to authorize issuance before moving forward.

Generate a policy and payment link

curl --location 'https://sandbox.yasmina.ai/api/v1/car-comp/policies' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer $ACCESS_TOKEN' \
  --data '{
    "benefits": [],
    "otp": "1234",
    "quote_request_id": 64,
    "quote_reference_id": "6237e1aa-cec2-440e-acb5-20bcb8e99750",
    "quote_price_id": "3adc577e-4dc4-f011-972d-005056a9891a"
}'

The response returns a policy draft and paymentLink you can surface to the customer.

Integration Guides

Single Insurance Provider

Comprehensive Motor Insurance

Seamless insurance for the cars you’re selling and the drivers that are buying from you.

TPL Motor Insurance

Seamless TPL motor insurance for drivers and vehicles.

SME Medical Insurance

Facilitate efficient and automated insurance claims processes between Healthcare Providers and Insurance Companies.

Travel Insurance

Schengen travel insurance with flexible duration and multi-traveller options.

Property Insurance

Embed property insurance into your platform, letting customers insure properties with a click.

Life Insurance (S&P)

Life insurance integration with S&P ratings support.

Multi Insurance Providers

Comprehensive Motor Insurance

Retrieve and compare quotes from multiple providers for comprehensive motor insurance.

TPL Motor Insurance

Request quotes from multiple providers for TPL motor insurance.

Property Insurance

Compare property insurance prices and providers to give customers options.

⌘I