> For the complete documentation index, see [llms.txt](https://docs.vpay.africa/vpay-api-specification-basic-gude/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vpay.africa/vpay-api-specification-basic-gude/methods/login.md).

# login

{% hint style="danger" %}
This endpoint is throttled to 1 request every 270000 milliseconds.
{% endhint %}

Request

<table><thead><tr><th width="196.5">Method</th><th>URL</th></tr></thead><tbody><tr><td><mark style="color:yellow;"><strong>POST</strong></mark></td><td><mark style="color:blue;"><strong>{{baseUrl}}</strong>/api/service/v1/query/merchant/login</mark></td></tr></tbody></table>

<table><thead><tr><th width="195.5">Header</th><th>Value</th></tr></thead><tbody><tr><td>Content-Type</td><td>application/json</td></tr><tr><td>publicKey</td><td>{{publicKey}}</td></tr></tbody></table>

<table><thead><tr><th>Request Body</th><th width="345.66666666666663">Description</th><th></th></tr></thead><tbody><tr><td>username</td><td>Merchant email or phone number</td><td>Mandatory</td></tr><tr><td>password</td><td>Merchant password</td><td>Mandatory</td></tr></tbody></table>