# Projects

A project is a funding goal for a business. Complete its Criteria, find matches, and create Deals.

Base URL: https://api.levr.ai/v1

Authentication: Bearer — Portal API key

[REST guide](https://docs.levr.ai/rest-api.md) · [OpenAPI specification](https://docs.levr.ai/generated/openapi.json)

OpenAPI defines exact REST schemas. Each record’s Application Contract defines its current questions and accepted answers.

## Work on a funding goal

A project records a business’s funding goal. Start by creating or reading the project, then complete its Criteria and find recommendations in the [Matchmaking guide](https://docs.levr.ai/guides/matchmaking.md).


- [List Projects](https://docs.levr.ai/rest-api-reference/projects/list-projects.md): `GET /projects/`

- [Create a Project](https://docs.levr.ai/rest-api-reference/projects/create-project.md): `POST /projects/`

- [Retrieve a Project](https://docs.levr.ai/rest-api-reference/projects/retrieve-project.md): `GET /projects/{project_id}/`

- [Update Project facts](https://docs.levr.ai/rest-api-reference/projects/update-project.md): `PATCH /projects/{project_id}/`

- [Move one Project to a workflow stage](https://docs.levr.ai/rest-api-reference/projects/move-project-stage.md): `PATCH /projects/{project_id}/stage/`

- [Retrieve the matchmaking application contract](https://docs.levr.ai/rest-api-reference/projects/retrieve-project-matchmaking-application-contract.md): `GET /projects/{project_id}/matchmaking-application/contract/`

- [Read shared matching criteria](https://docs.levr.ai/rest-api-reference/projects/get-project-matchmaking-request.md): `GET /projects/{project_id}/matchmaking-request/`

- [Edit shared matching criteria](https://docs.levr.ai/rest-api-reference/projects/update-project-matchmaking-request.md): `PATCH /projects/{project_id}/matchmaking-request/`

- [List shared matchmaking application answers](https://docs.levr.ai/rest-api-reference/projects/list-project-matchmaking-answers.md): `GET /projects/{project_id}/matchmaking-application/answers/`

- [Update shared matchmaking application answers](https://docs.levr.ai/rest-api-reference/projects/update-project-matchmaking-answers.md): `PATCH /projects/{project_id}/matchmaking-application/answers/`

- [List repeatable answer items](https://docs.levr.ai/rest-api-reference/projects/list-project-matchmaking-application-repeatable-items.md): `GET /projects/{project_id}/matchmaking-application/answers/repeatable-items/`

- [Create a repeatable answer item](https://docs.levr.ai/rest-api-reference/projects/create-project-matchmaking-application-repeatable-item.md): `POST /projects/{project_id}/matchmaking-application/answers/repeatable-items/`

- [Update a repeatable answer item](https://docs.levr.ai/rest-api-reference/projects/update-project-matchmaking-application-repeatable-item.md): `PATCH /projects/{project_id}/matchmaking-application/answers/repeatable-items/`

- [Delete a repeatable answer item](https://docs.levr.ai/rest-api-reference/projects/delete-project-matchmaking-application-repeatable-item.md): `DELETE /projects/{project_id}/matchmaking-application/answers/repeatable-items/`

- [List answer files](https://docs.levr.ai/rest-api-reference/projects/list-project-matchmaking-application-answer-files.md): `GET /projects/{project_id}/matchmaking-application/answers/files/`

- [Request an answer-file upload](https://docs.levr.ai/rest-api-reference/projects/create-project-matchmaking-application-answer-file-upload.md): `POST /projects/{project_id}/matchmaking-application/answers/files/`

- [Upload an answer file](https://docs.levr.ai/rest-api-reference/projects/upload-project-matchmaking-application-answer-file.md): `POST /projects/{project_id}/matchmaking-application/answers/files/{upload_id}/`

- [Delete an answer file](https://docs.levr.ai/rest-api-reference/projects/delete-project-matchmaking-application-answer-file.md): `DELETE /projects/{project_id}/matchmaking-application/answers/files/`

- [Get matchmaking application autofill preparation](https://docs.levr.ai/rest-api-reference/projects/get-project-matchmaking-application-autofill-preparation.md): `GET /projects/{project_id}/matchmaking-application/autofill-preparation/`

- [Start matchmaking application autofill](https://docs.levr.ai/rest-api-reference/projects/start-project-matchmaking-application-autofill.md): `POST /projects/{project_id}/matchmaking-application/autofill-runs/`

- [Update matchmaking application autofill preparation](https://docs.levr.ai/rest-api-reference/projects/update-project-matchmaking-application-autofill-preparation.md): `PATCH /projects/{project_id}/matchmaking-application/autofill-preparation/`

- [Upload one autofill preparation file](https://docs.levr.ai/rest-api-reference/projects/upload-project-matchmaking-application-autofill-preparation-file.md): `POST /projects/{project_id}/matchmaking-application/autofill-preparation/files/`

- [Poll matchmaking application autofill](https://docs.levr.ai/rest-api-reference/projects/get-project-matchmaking-application-autofill-run.md): `GET /project-matchmaking-application-autofill-runs/{run_id}/`

- [List matchmaking application autofill suggestions](https://docs.levr.ai/rest-api-reference/projects/list-project-matchmaking-application-autofill-suggestions.md): `GET /project-matchmaking-application-autofill-runs/{run_id}/suggestions/`

- [Accept autofill suggestion](https://docs.levr.ai/rest-api-reference/projects/accept-project-matchmaking-autofill-suggestion.md): `POST /project-matchmaking-application-autofill-runs/{run_id}/suggestions/{suggestion_id}/accept/`

- [Retry unfinished matchmaking application autofill work](https://docs.levr.ai/rest-api-reference/projects/retry-project-matchmaking-application-autofill-run.md): `POST /project-matchmaking-application-autofill-runs/{run_id}/retry/`

- [Calculate recipient matches](https://docs.levr.ai/rest-api-reference/projects/calculate-project-matches.md): `POST /projects/{project_id}/matchmaking-runs/`

- [Poll a match calculation](https://docs.levr.ai/rest-api-reference/projects/retrieve-project-matchmaking-run.md): `GET /project-matchmaking-runs/{run_id}/`

- [List persisted match results](https://docs.levr.ai/rest-api-reference/projects/list-project-matchmaking-results.md): `GET /project-matchmaking-runs/{run_id}/results/`

- [Read shared recipient choices](https://docs.levr.ai/rest-api-reference/projects/list-project-matchmaking-selections.md): `GET /projects/{project_id}/matchmaking-selections/`

- [Merge shared recipient choices](https://docs.levr.ai/rest-api-reference/projects/update-project-matchmaking-selections.md): `PATCH /projects/{project_id}/matchmaking-selections/`

- [Retry failed recipient matches](https://docs.levr.ai/rest-api-reference/projects/retry-project-matchmaking-run.md): `POST /project-matchmaking-runs/{run_id}/retry/`

- [Cancel unresolved recipient matching](https://docs.levr.ai/rest-api-reference/projects/cancel-project-matchmaking-run.md): `POST /project-matchmaking-runs/{run_id}/cancel/`