# UseAgents API Documentation

The UseAgents API lets you search the tool registry and build integrations around UseAgents data. Start here to understand the base URL, authentication model, response behavior, and supporting reference pages.

## Base URL

The UseAgents API is HTTPS-only and follows standard REST patterns. All requests use the following base URL:

```
https://api.useagents.site
```

## Authentication

Protected endpoints require an `Authorization` header with your API key as a Bearer token.

```
Authorization: Bearer YOUR_API_KEY
```

Learn more about [Authentication](/content/docs/api-reference/authentication/index.html) and [API Keys](/content/docs/reference/api-keys/index.html).

## Response codes

UseAgents uses standard HTTP status codes. In general:

- `2xx` means the request succeeded  
- `4xx` means the request was invalid, unauthorized, or rate limited  
- `5xx` means the request failed due to a server-side issue

| Status | Description |
| --- | --- |
| `200` | Successful request. |
| `400` | Bad request. Check that the parameters were correct. |
| `401` | The API key was missing. |
| `403` | The API key was invalid. |
| `404` | The resource was not found. |
| `422` | Validation error with one or more fields. |
| `429` | The rate limit was exceeded. |
| `5xx` | Indicates an error with UseAgents servers. |

Check [Errors](/content/docs/api-reference/errors/index.html) for a full breakdown of common failure cases.

## Rate limits

Authenticated endpoints are rate limited to protect service stability and ensure fair usage. If you exceed the allowed rate, the API returns `429 Too Many Requests`. Learn more on the [Rate Limits](/content/docs/api-reference/rate-limit/index.html) page.

## Versioning

UseAgents aims to keep existing integrations stable as the API evolves. Learn more on the [Versioning](/content/docs/api-reference/versioning/index.html) page.

## Next steps

- [Authentication](/content/docs/api-reference/authentication/index.html) to add the correct headers  
- [Tools Search](/content/docs/api-reference/tools-search/index.html) for the main search endpoint  
- [Errors](/content/docs/api-reference/errors/index.html) to troubleshoot failed requests