> For the complete documentation index, see [llms.txt](https://docs.mifos.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mifos.org/mifosx/developer-space/using-rest-client-for-testing.md).

# Using REST client for testing

To check if your installation of MifosX instance is working properly or not or for the changes you made, you can use a REST client for testing the installation/change properly.\
\
Here in this guide, we would be using one of the famous REST client **Postman** but you need not to necessarily use it, any REST client would do.\
\
We will be assuming few things beforehand:

```
URL: https://localhost/fineract-provider/api/v1/
Username: mifos
Password: password
Tenant ID: default
```

{% hint style="info" %}
Note: You will get this configuration if you have followed all the steps given the MifosX installation guide, this is default configuration for the server.
{% endhint %}

### Steps

* Open up the Postman and you will see something like this:

![Empty Postman](/files/-M6rgZj4ddrJF9rCbfSP)

* Enter URL: <https://localhost/fineract-provider/api/v1/offices\\>
  Request type would be GET (which is default).
* In Authorization tab, select 'Basic Auth' and fill up username as *mifos* and *password* (default credentials).

![Authorization Tab](/files/-M6s6XfNwaQarwyxaG7F)

* Next up, we will edit Headers Tab.\
  Fill 'Accept' in key section for the first header and 'application/json' in value section.\
  Fill 'Fineract-Platform-TenantId' in key section for the second header and 'default' in value section. ('default' is default TenantId for a MifosX instance)

![Header Tab](/files/-M6s7esZOp1z3lvrh5ak)

* We're done, now just click on the 'Request' Button given near the URL text box. And voila!\
  If your instance is running correctly, you would see Response Code as 200 and a valid json response.\
  Here is sample response:

![Sample Response](/files/-M6sNGRFaeFVS1nxXwBX)

### Steps for a POST request

You may also want to do a POST request and couldn't figure how to do it properly.

* We'll keep headers and authorization tabs intact as they were in GET request above.
* We'll select POST from the dropdown near URL text box and change the URL to <https://localhost/fineract-provider/api/v1/staff>.

![It should look something like this](/files/-M6sQZ5THdu-TSW21Tqn)

* Now, go to 'Body' tab and fill up with this sample request.

```
{
   "isLoanOfficer":true,
   "officeId":1,
   "firstname":"bharath",
   "lastname":"c",
   "joiningDate":"02 March 2020",
   "locale":"en",
   "dateFormat":"dd MMMM yyyy"
}
```

![Body for the POST request](/files/-M6sUS82mF1DXZmIKR_P)

* Click on Send Button and done! If everything is fine, then you will see a response similar to this:

![Sample Response for the POST Request](/files/-M6sYX8LjlC1VnDJCyD4)

{% hint style="info" %}
In case you want to test other API endpoints, checkout API docs [here](https://demo.mifos.io/api-docs/apiLive.htm).
{% endhint %}