Error Reference
Common ErrorsQuick Solutions
Most frequently encountered errors and how to resolve them quickly
Error Distribution
35%
Validation Errors
25%
Not Found Errors
20%
Business Logic Errors
10%
Permission Errors
10%
System Errors
invalid_activity_type< 2 min"The specified activity type is not supported"
Common Causes
- Activity type not in approved list
- Typo in activity name
- Coverage not available in state
Solutions
- Check supported activity types in API docs
- Verify exact spelling (case-sensitive)
- Confirm coverage available in member's state
- Use activity_type from GET /activities endpoint
policy_creation_failed< 5 min"Unable to create policy with provided data"
Common Causes
- Missing required fields
- Invalid date range
- Coverage limits exceeded
- Member ineligible
Solutions
- Verify all required fields present
- Check event date is in future
- Confirm coverage amount within limits
- Validate member age and eligibility
- Review error details in response
member_not_found< 1 min"No member exists with provided ID"
Common Causes
- Incorrect member ID
- Member deleted
- Wrong environment
- ID from different account
Solutions
- Verify member ID is correct
- Check member exists in current environment
- Search by email if ID unknown
- Create member if doesn't exist
coverage_not_available< 3 min"Requested coverage not available for this activity/location"
Common Causes
- State not licensed
- Activity excluded
- Temporary unavailability
- Account restrictions
Solutions
- Check state licensing status
- Review excluded activities list
- Verify account has feature enabled
- Contact support for state expansion
duplicate_policy< 1 min"Policy already exists for this member and event"
Common Causes
- Double submission
- Retry without idempotency key
- Existing active policy
Solutions
- Check for existing policy first
- Use idempotency keys for retries
- Query policies by member and date
- Update existing policy if needed
validation_error< 5 min"One or more fields failed validation"
Common Causes
- Invalid email format
- Date in past
- Negative amount
- Text too long
Solutions
- Review field requirements in docs
- Validate data before sending
- Check string length limits
- Ensure proper date formats (ISO 8601)
claim_submission_failed< 10 min"Unable to submit claim with provided information"
Common Causes
- Missing documentation
- Claim window expired
- Policy not found
- Invalid claim type
Solutions
- Provide all required documents
- Submit within 30 days of incident
- Verify policy ID is correct
- Match claim type to policy coverage
refund_not_eligible< 5 min"Policy or member not eligible for refund"
Common Causes
- Outside refund window
- Event already occurred
- Cancellation not covered
- Partial refund only
Solutions
- Check refund policy terms
- Verify cancellation reason is covered
- Review event date vs. refund request date
- Provide required documentation
Error Prevention Tips
Always validate data before sending to API
Use TypeScript for type safety and auto-completion
Implement proper error handling and user feedback
Test with invalid data to catch edge cases
Log errors with context for easier debugging
Use idempotency keys for retry-safe operations
Cache responses to reduce API calls
Monitor error rates in your dashboard