/projects
Projects API is for reporting on pricing project states and to aid in building custom quote flows
Retrieve all projects
Project reference. It is a UUID.
56c575d2-b6b9-44ed-9c75-5d705b987ec1
Pricing project published status. It can be in draft, approved, published or subsequently unpublished
draft
GET /sw/projects HTTP/1.1
Host: api.llow.io
Accept: */*
/sw/projects response
{
"project_reference": "56c575d2-b6b9-44ed-9c75-5d705b987ec1",
"version_reference": "46c575d2-b6b9-44ed-9c75-5d705b987ec1",
"company_reference": "86c575d2-b6b9-44ed-9c75-8d705b987ec1",
"name": "Monthly motor insurance product",
"description": "Monthly motor insurance product for the UK market",
"summary": "<p>Example change log of version</p>",
"version": 1,
"status": "draft",
"size": 8.6,
"disabled": false,
"approved_at": "2021-04-22T14:29:22.000Z",
"published_at": "2021-04-22T14:29:22.000Z",
"updated_at": "2021-04-22T14:29:22.000Z",
"created_at": "2021-03-22T14:29:22.000Z",
"versions": [
{}
]
}
This will retrieve all projects within your account. It will show the latest published version along with other useful project details.
Retrieve a specific project
Project reference. It is a UUID.
56c575d2-b6b9-44ed-9c75-5d705b987ec1
Pricing project published status. It can be in draft, approved, published or subsequently unpublished
draft
Project version reference. It is a UUID.
46c575d2-b6b9-44ed-9c75-5d705b987ec1
GET /sw/projects/{project_reference} HTTP/1.1
Host: api.llow.io
Accept: */*
/sw/projects/{project_reference} response
{
"project_reference": "56c575d2-b6b9-44ed-9c75-5d705b987ec1",
"version_reference": "46c575d2-b6b9-44ed-9c75-5d705b987ec1",
"company_reference": "86c575d2-b6b9-44ed-9c75-8d705b987ec1",
"name": "Monthly motor insurance product",
"description": "Monthly motor insurance product for the UK market",
"summary": "<p>Example change log of version</p>",
"version": 1,
"status": "draft",
"size": 8.6,
"disabled": false,
"approved_at": "2021-04-22T14:29:22.000Z",
"published_at": "2021-04-22T14:29:22.000Z",
"updated_at": "2021-04-22T14:29:22.000Z",
"created_at": "2021-03-22T14:29:22.000Z",
"versions": [
{}
]
}
This will show a specific project with the latest published version, all versions to date and their status.
Each project has a unique project_reference and each version has a unique version_reference.
Retrieve all project versions
Project reference. It is a UUID.
56c575d2-b6b9-44ed-9c75-5d705b987ec1
Project version reference. It is a UUID.
46c575d2-b6b9-44ed-9c75-5d705b987ec1
A html formatted change log of a project version.
<p>Example change log of version</p>
GET /sw/projects/versions HTTP/1.1
Host: api.llow.io
Accept: */*
/sw/projects/versions response
{
"project_reference": "56c575d2-b6b9-44ed-9c75-5d705b987ec1",
"version_reference": "46c575d2-b6b9-44ed-9c75-5d705b987ec1",
"company_reference": "86c575d2-b6b9-44ed-9c75-8d705b987ec1",
"name": "Monthly motor insurance product",
"description": "Monthly motor insurance product for the UK market",
"summary": "<p>Example change log of version</p>",
"version": 1,
"status": "draft",
"size": 8.6,
"disabled": false,
"approved_at": "2021-04-22T14:29:22.000Z",
"published_at": "2021-04-22T14:29:22.000Z",
"updated_at": "2021-04-22T14:29:22.000Z",
"created_at": "2021-03-22T14:29:22.000Z"
}
Project versions can be returned in bulk or filtered via the summary change log (using ?summary)
https://api.llow.io/sw/projects/versions?summary=search%20term
or via project_reference
https://api.llow.io/sw/projects/versions?project_reference=56c575d2-b6b9-44ed-9c75-5d705b987ec1
Help building your own quote flows
Project reference. It is a UUID.
56c575d2-b6b9-44ed-9c75-5d705b987ec1
GET /sw/public/projects/{project_reference} HTTP/1.1
Host: api.llow.io
Accept: */*
/sw/public/projects/{project_reference} response
{
"version_reference": "46c575d2-b6b9-44ed-9c75-5d705b987ec1",
"project_reference": "56c575d2-b6b9-44ed-9c75-5d705b987ec1",
"version": 1,
"updated_at": "2021-04-22T14:29:22.000Z",
"inputs": {
"bike_type": {
"type": "string",
"label": "Your bike type",
"def": "Road"
}
},
"lists": {
"bike_type": {
"type": "string",
"data": [
"Road",
"Mountain",
"BMX"
]
}
}
}
The public project endpoint will return all the input parameters needed for a Swallow pricing project and all the lists of data options (generated by factor table data). This allows you to build custom and validated custom quote flows.
The quote flows can be programmatic (aggregator integrations) or via custom build user interfaces (within an app or website).
Last updated