> For the complete documentation index, see [llms.txt](https://capitalsage.gitbook.io/sagecloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://capitalsage.gitbook.io/sagecloud/authorization/authentication.md).

# Authentication

## Merchant Authorization

<mark style="color:green;">`POST`</mark> `https://sagecloud.ng/api/v2/merchant/authorization`

This endpoint allows your authentication

#### Headers

| Name         | Type   | Description                      |
| ------------ | ------ | -------------------------------- |
| Accept       | string | This should be: application/json |
| Content-Type | string | This should be: application/json |

#### Request Body

| Name     | Type   | Description         |
| -------- | ------ | ------------------- |
| email    | string | Your login email    |
| password | string | Your login password |

{% tabs %}
{% tab title="200 Successfully logged in." %}

```
{
    "success": true,
    "data": {
        "business_name": "My business",
        "token": {
            "access_token": {a generated token will be here},
            "token_type": "Bearer",
            "expires_at": "2030-05-12 15:53:34"
        }
    }
}
```

{% endtab %}

{% tab title="401 Incorrect credentials" %}

```
{
    "success": false,
    "message": "These business credentials do not match our records. Please check and try again"
}
```

{% endtab %}
{% endtabs %}
