# Error Handling - SMB Sales Boost API

All errors follow a consistent format with an `error` code and a human-readable `message`.

### Error Response Format

```
{
  "error": "bad_request",
  "message": "No valid fields provided. Allowed: firstName, lastName, companyName, companyWebsite"
}
```

### HTTP Status Codes

| Status | Meaning                                                     |
| ------ | ----------------------------------------------------------- |
| 200    | OK - Request succeeded                                      |
| 201    | Created - Resource created successfully                     |
| 400    | Bad Request - Invalid parameters or missing required fields |
| 401    | Unauthorized - Invalid or missing API key                   |
| 403    | Forbidden - API access not available on your plan           |
| 404    | Not Found - Resource does not exist                         |
| 429    | Too Many Requests - Rate limit exceeded                     |
| 500    | Internal Server Error - Something went wrong on our end     |

---

### API Documentation Sections

[Introduction](/docs/api/introduction) | [Programmatic Purchase](/docs/api/programmatic-purchase) | [Authentication](/docs/api/authentication) | [Rate Limits](/docs/api/rate-limits) | [User Profile](/docs/api/user-profile) | [Leads](/docs/api/leads) | [Filter Presets](/docs/api/filter-presets) | [Keyword Lists](/docs/api/keyword-lists) | [Email Schedules](/docs/api/email-schedules) | [Export Formats](/docs/api/export-formats) | [Export History](/docs/api/export-history) | [Account Settings](/docs/api/account-settings) | [AI Features](/docs/api/ai-features) | [Export Blacklist](/docs/api/export-blacklist) | **Error Handling** | [Credits & Subscription](/docs/api/credits-subscription) | [MCP Server](/docs/api/mcp-server) | [Integrations](/docs/api/integrations)

[View Full API Documentation](/docs/api)

---

**Ready to Find Your Next Customers?** Get access to newly registered business leads updated every 5 minutes. [Get Started](/?utm%5Fsource=content&utm%5Fmedium=cta)