---
description: >-
  Projects API is for reporting on pricing project states and to aid in building
  custom quote flows
---

# /projects

**Retrieve all projects**

{% openapi src="https://1110149073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu89vYHjuY9Vj4vhZX5IZ%2Fuploads%2FHq1XfYRcYOI2opkc1T2i%2Fopenapi_5.json?alt=media&token=0660dd0c-e092-481e-82ed-71adc8066362" path="/sw/projects" method="get" %}
[openapi_5.json](https://1110149073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu89vYHjuY9Vj4vhZX5IZ%2Fuploads%2FHq1XfYRcYOI2opkc1T2i%2Fopenapi_5.json?alt=media&token=0660dd0c-e092-481e-82ed-71adc8066362)
{% endopenapi %}

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**&#x20;

{% openapi src="https://1110149073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu89vYHjuY9Vj4vhZX5IZ%2Fuploads%2FHq1XfYRcYOI2opkc1T2i%2Fopenapi_5.json?alt=media&token=0660dd0c-e092-481e-82ed-71adc8066362" path="/sw/projects/{project_reference}" method="get" %}
[openapi_5.json](https://1110149073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu89vYHjuY9Vj4vhZX5IZ%2Fuploads%2FHq1XfYRcYOI2opkc1T2i%2Fopenapi_5.json?alt=media&token=0660dd0c-e092-481e-82ed-71adc8066362)
{% endopenapi %}

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**

{% openapi src="https://1110149073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu89vYHjuY9Vj4vhZX5IZ%2Fuploads%2FHq1XfYRcYOI2opkc1T2i%2Fopenapi_5.json?alt=media&token=0660dd0c-e092-481e-82ed-71adc8066362" path="/sw/projects/versions" method="get" %}
[openapi_5.json](https://1110149073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu89vYHjuY9Vj4vhZX5IZ%2Fuploads%2FHq1XfYRcYOI2opkc1T2i%2Fopenapi_5.json?alt=media&token=0660dd0c-e092-481e-82ed-71adc8066362)
{% endopenapi %}

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**

{% hint style="info" %}
This is a **public** API endpoint. You can hit this endpoint for client-side code by just providing _**client\_id\_key**_ in the header. View [authentication](../authentication) to find out more. Public APIs have **/public/** within the endpoint url.
{% endhint %}

{% openapi src="https://1110149073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu89vYHjuY9Vj4vhZX5IZ%2Fuploads%2FHq1XfYRcYOI2opkc1T2i%2Fopenapi_5.json?alt=media&token=0660dd0c-e092-481e-82ed-71adc8066362" path="/sw/public/projects/{project_reference}" method="get" %}
[openapi_5.json](https://1110149073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu89vYHjuY9Vj4vhZX5IZ%2Fuploads%2FHq1XfYRcYOI2opkc1T2i%2Fopenapi_5.json?alt=media&token=0660dd0c-e092-481e-82ed-71adc8066362)
{% endopenapi %}

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).

