POST
/
offers
Life S&P Products
curl --request POST \
  --url https://staging.yasmina.ai/api/v1/life-snp/offers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "applicant_id": "0123456789",
  "date_of_birth": "1990-06-15",
  "gender": "male",
  "smoker": false,
  "policy_term_years": 20,
  "premium_frequency": "monthly",
  "target_premium": 250
}'
[
  {
    "offer_id": "<string>",
    "insurer": "<string>",
    "sum_assured": 123,
    "premium": 123,
    "premium_frequency": "<string>",
    "policy_term_years": 123,
    "riders_included": [
      "<string>"
    ],
    "maturity_benefit": true,
    "notes": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
applicant_id
string
required

Saudi National ID of the applicant (10 digits).

​
date_of_birth
string<date>
required

YYYY-MM-DD

​
gender
enum<string>
required
Available options:
male,
female
​
smoker
boolean
required
​
policy_term_years
integer
required
Required range: 5 <= x <= 40
​
premium_frequency
enum<string>
required
Available options:
monthly,
quarterly,
semi_annual,
annual
​
sum_assured
number
required

SAR. Required if target_premium is not provided.

Required range: x >= 10000
​
height_cm
number
Required range: 100 <= x <= 250
​
weight_kg
number
Required range: 30 <= x <= 300
​
occupation_class
string

Insurer occupation class code or text.

​
annual_income_sar
number
Required range: x >= 0
​
target_premium
number

SAR per chosen frequency. Required if sum_assured is not provided.

Required range: x >= 50
​
riders
object
​
distribution_channel
enum<string>
default:bank
Available options:
bank
​
extra_fields
object

Optional key-value extras (max JSON-encoded size 255 chars).

Response

Success

​
offer_id
string
​
insurer
string
​
sum_assured
number
​
premium
number
​
premium_frequency
string
​
policy_term_years
integer
​
riders_included
string[]
​
maturity_benefit
boolean

Payout on maturity if applicable.

​
notes
string