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

# FAQ & Troubleshooting

## FAQ

### Q: How long are API keys valid?
**A:** API keys don't expire but can be revoked. Contact support for new keys.

### Q: Can I use one API key for multiple applications?
**A:** Yes, but monitor usage separately with different API keys for better security.

### Q: What's the maximum number of properties per agent?
**A:** No limit. Use pagination to handle large result sets.

### Q: Are there batch endpoints for multiple properties?
**A:** Not currently. Use pagination to retrieve multiple properties efficiently.

### Q: Can I filter properties by price range?
**A:** Not in the API. Filter results in your application.

### Q: How often is property data updated?
**A:** Data updates hourly from MLS feeds.

### Q: Can I get historical property data?
**A:** Contact support for historical data access.

### Q: Is there a sandbox/test environment?
**A:** Use v2 with test API keys for testing.

## Troubleshooting

### Problem: 401 Unauthorized

**Causes:**
- API key missing or incorrect
- API key revoked
- Wrong header name

**Solution:**
```bash
# Verify header format
curl -H 'apikey: YOUR_KEY' https://ws.spac.io/api/v1/getProperties

# Not: api-key or Api-Key
```

### Problem: 429 Rate Limited

**Causes:**
- Exceeded 12,000 requests/hour
- Too many concurrent requests

**Solution:**
- Wait for rate limit reset
- Implement exponential backoff
- Cache frequently accessed data

### Problem: Empty Results

**Causes:**
- Wrong property/agent ID
- Data doesn't exist
- No access permissions

**Solution:**
```python
# Verify ID exists
if response['success'] and response['data']:
    print(response['data'])
else:
    print('No results found')
```

### Problem: Slow Responses

**Causes:**
- Large result sets
- Network latency
- Server load

**Solution:**
- Reduce page limit
- Use caching
- Add timeout handling

### Problem: Inconsistent Data

**Causes:**
- Data updated between requests
- Timing issues

**Solution:**
- Add updated_at timestamp comparison
- Implement caching strategy
- Sync less frequently if needed

### Getting Help

- Email: support@spac.io
- Phone: 1-800-SPACIO-1
- Status page: status.spac.io
- Community: forums.spac.io