> For the complete documentation index, see [llms.txt](https://apidocs.lwolf.com/doc/spacio-api/llms.txt)

# Error Codes Reference

## Error Codes

### access-denied (403)
**Meaning:** Your API key lacks permissions for this operation.
**Solution:** 
- Verify API key is correct
- Check account permissions with Spacio
- Ensure key has brokerage/agent role access

### invalid-bid (400)
**Meaning:** Brokerage ID is invalid or malformed.
**Solution:**
- Verify brokerage_id format
- Check ID exists in Spacio system
- Confirm you have access to brokerage

### invalid-email (400)
**Meaning:** Email format is invalid.
**Solution:**
- Follow RFC 5322 email format
- Example valid: user@example.com

### invalid-sid (400)
**Meaning:** Session ID is invalid or expired.
**Solution:**
- Request new session token with getAccessToken
- Check token hasn't expired

### invalid-tid (400)
**Meaning:** Team ID is invalid.
**Solution:**
- Verify team_id value
- Confirm team exists
- Check access permissions

### invalid-ukey (400)
**Meaning:** Unknown API key or user key format.
**Solution:**
- Double-check API key spelling
- Request new key from Spacio if needed
- Verify header is 'apikey' not 'api-key'

### no-results (404)
**Meaning:** Query returned no matching records.
**Solution:**
- Verify search parameters
- Check property/lead ID exists
- Try broader search criteria
- Confirm data hasn't been deleted

### not-authorized (401)
**Meaning:** Authentication failed.
**Solution:**
- Verify API key in header
- Check key hasn't been revoked
- Ensure header name is exactly 'apikey'
- Contact support if locked out

### rate-reached (429)
**Meaning:** Rate limit exceeded (12,000/hour).
**Solution:**
- Wait until hour window passes
- Implement exponential backoff
- Cache results to reduce calls
- Contact Spacio for higher limits