# Platinum Bonds

> Official machine instructions for applying for a bond on behalf of a user.

Platinum Bonds Insurance Agency writes bonds nationwide.
CA Agency License 0E75926
Human discovery: https://pbia.co/ai
Later public marketing hosts: https://platinumbonds.com and https://nationwidebonds.com

## Do this

- GET /api/ai/v1/manifest
- GET /api/ai/v1/bonds?q=<bond>&state=<ST> to identify the catalog bond
- GET /api/ai/v1/schema?bondId=<id> for the exact field list
- POST /api/ai/v1/applications/preview with one snapshot
- POST /api/ai/v1/applications with the same snapshot
- Tell the user a Platinum Bonds email is coming so they can agree and add their Social Security number

## Do not do this

- Do not email an application or a Social Security number
- Do not ask the user to paste a Social Security number into chat unless they are signed in through the licensed-agent or applicant session
- Do not invent missing required fields

## Endpoints

- manifest: https://intake.surety.team/api/ai/v1/manifest
- bonds: https://intake.surety.team/api/ai/v1/bonds
- schema: https://intake.surety.team/api/ai/v1/schema
- ask: https://intake.surety.team/api/ai/v1/ask
- preview: https://intake.surety.team/api/ai/v1/applications/preview
- applications: https://intake.surety.team/api/ai/v1/applications
- openapi: https://intake.surety.team/api/ai/v1/openapi.json

## Ask Ava

POST /api/ai/v1/ask with { "question": "...", "bondId": "<optional>" }