Skip to main content
POST
Issue policy

Authorizations

Authorization
string
header
required

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

Body

application/json
offer_id
string
required

Offer identifier returned by /offers.

applicant_id
string
required
Pattern: ^\d{10}$
date_of_birth
string<date>
required
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
agreed_premium
number
required
Required range: x >= 50
start_date
string<date>
required
beneficiaries
object[]
required
Minimum array length: 1

Customer consents to policy issuance and bank auto-debit.

sum_assured
number
Required range: x >= 10000
iban
string

Customer bank IBAN for premium collection.

Example:

"SA0380000000608010167519"

extra_fields
object

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

Response

Created

id
integer
client_id
string
provider_policy_id
integer
provider_policy
string
start_date
string
end_date
string
policy_term_years
integer
sum_assured
number
premium_amount
number
premium_frequency
string
approval_status
integer
order_status
integer
status
string
Example:

"active"

beneficiaries
object[]
iban_masked
string
Example:

"SA03*****************519"

is_claimed
boolean
canceled_at
string | null
invoice
string
cancellation_document
string
meta_data
object
created_at
string
updated_at
string