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