Skip to main content
Endpoint: 
GET /api/external/companies/{companyId}/submissions
Retrieves a list of submissions for a specific company.

​
Parameters

ParameterTypeRequiredDescription
companyIdstring (UUID)YesThe company identifier
sortBystringYesSort field. Options: updatedAt, createdAt, primaryInsuredName
sortDirectionstringYesSort direction. Options: asc, desc
statusstring | string[]NoFilter by submission status
typestring[]NoFilter by submission type(s)
filterTextstringNoText filter for searching submissions
pagenumberNoPage number for pagination

​
Response

{
  "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>"