# Getting Started

## 🥷 Authentication

Go to the <https://ismalicious.com/auth/login> and sign into your account.

## 🔐 Get your API keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

You can generate new API keys pair from the [account page](https://ismalicious.com/app/account) any time.

<figure><img src="https://1828463927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSDJoO1WvUWUOCAzs8yiW%2Fuploads%2FiIHUjJL3RARNbKcgqitF%2FCleanShot%202024-11-28%20at%2022.20.31.png?alt=media&#x26;token=4827226a-7304-41f8-992d-4167d2ac6fbe" alt=""><figcaption></figcaption></figure>

The best way to interact with our API is to use one of popular libraries such as:

{% embed url="<https://curl.se>" %}

## 🌍  Base URL Setup

All API requests are made to the following base URL: <https://ismalicious.com/api/>

### 🚀 Request Sample

You can make requests to the isMalicious API using any HTTP client, such as `curl`, Postman, or your preferred programming language's HTTP(S) tool or library.

#### Example with curl

```bash
curl -X GET "https://ismalicious.com/api/check?ip=1.41.36.173" -H "X-API-KEY: your_api_key_here"
```

Now that you know the basics, let's dive into the specific endpoints.

## Send your first check request 👇

{% content-ref url="technical-docs/api-reference/check-ressource" %}
[check-ressource](https://docs.ismalicious.com/technical-docs/api-reference/check-ressource)
{% endcontent-ref %}