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"

import fetch from "node-fetch";

const response = await fetch("https://sandbox.yasmina.ai/oauth/token", {
  method: "POST",
  headers: {
    Authorization: `Basic ${Buffer.from(`${process.env.CLIENT_ID}:${process.env.CLIENT_SECRET}`).toString("base64")}`,
    "Content-Type": "application/x-www-form-urlencoded"
  },
  body: "grant_type=client_credentials"
});

const { access_token: accessToken } = await response.json();
console.log(accessToken);

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"
}'