Get an order for a customer
GET/v1/orders/:id
Get an order for a customer.
Request
Path Parameters
The ID of the order to retrieve
Responses
- 200
- 404
OK
- application/json
- Schema
- Example (from schema)
Schema
order object
An order for an insurance product
The unique ID of the order.
the current status of the order.
the amount due for payment by partner, excluding the partner's commission
The date when the policy coverage is due to start
An optional identifier for the asset the insurance covers. You may set this to a value that uniquley identifies the asset on your database.
The currency of all monetary parameters.
The channel through which the order was made.
The method of payment used for the order.
product object
An individual insurance product or plan
The name of the product
The unique identifier for technical purposes
Unique Id of the product.
insurer object
An insurance provider
The unique code of the insurer
The name of the insurer
A link to the Insurer's logo
Insurer's terms and conditions
product type object
A major category of insurance e.g Health, Automobile, Life, Gadget, Goods in transit, etc
The generally accepted human friendly name
The unique identifier for technical purposes
list of the nefits covered.
Date of product creation
Price of product
Define the product premium tier.
Possible values: [monthly
, quarterly
, annually
]
Default value: annually
customer object
The the customer's information
Unique identifier for the customer on your system
The customer's email address
The policy for which the order was made.
{
"order": {
"id": 2,
"status": "paid",
"amount_due": 1470,
"policy_start_date": "2022-04-06T00:00:00.000000Z",
"asset_ref": "T2354354",
"currency": "GHS",
"channel": "API",
"created_at": "2022-04-06T10:34:20.000000Z",
"payment_made_at": "2022-04-06T10:34:20.000000Z",
"payment_method": "wallet",
"product": {
"title": "Comprehensive Car Plan XYZ",
"code": "auto-com-xyz",
"id": 1,
"insurer": {
"code": "AXA",
"name": "Axa Mansard",
"logo_url": null,
"terms_conditions": null
},
"product type": {
"name": "Goods in Transit",
"slug": "GIT"
},
"cover-benefits": {},
"created-at": "string",
"price": 0,
"premium-type": "string",
"premium-rate-unit": 0,
"premium-rate": 0,
"premium": 0,
"partner-commision-rate": 0,
"min-premium": "string",
"premium-rules": "string",
"premium_frequency": "annually"
},
"customer": {
"ref": "string",
"email": "string",
"phone": "408-867-5309",
"first_name": "Jane",
"last_name": "Doe"
},
"policy": null
}
}
Not Found
- application/json
- Schema
- Example (from schema)
Schema
{
"message": "Order not found"
}