List Submissions

Endpoint:

GET /api/external/companies/{companyId}/submissions

Retrieves a list of submissions for a specific company.

Parameters

Parameter	Type	Required	Description
companyId	string (UUID)	Yes	The company identifier
sortBy	string	Yes	Sort field. Options: updatedAt, createdAt, primaryInsuredName
sortDirection	string	Yes	Sort direction. Options: asc, desc
status	string | string[]	No	Filter by submission status
type	string[]	No	Filter by submission type(s)
filterText	string	No	Text filter for searching submissions
page	number	No	Page number for pagination

Response

Status: 200 OK

{
  "submissions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T14:22:00.000Z",
      "status": "submitted",
      "type": "new_business",
      "number": "SUB-2024-001",
      "primaryInsuredName": "ABC Corporation",
      "applicationId": "550e8400-e29b-41d4-a716-446655440001",
      "name": "General Liability Application"
    }
  ],
  "totalCount": 25,
  "surfaceCounts": {
    "emailSubmissionsInbox": 5
  }
}

Submission Status Values

• draft - Submission is being prepared
• submitted - Submission has been submitted for review
• under_review - Submission is being reviewed
• quoted - Quote has been generated
• bound - Policy has been bound
• declined - Submission was declined

Submission Types

• new_business - New business submission
• renewal - Policy renewal submission
• endorsement - Policy endorsement submission

Example Requests

cURL

curl -X GET \
  "https://app.aiinsurance.io/api/external/companies/<YOUR-COMPANY-ID>/submissions?status=submitted&sortBy=createdAt&sortDirection=desc&page=1" \
  -H "Authorization: ApiKey <YOUR-API-KEY>"