# Testing the API

Spotnana API documentation allows you to test the endpoints directly from this website.
To do so, follow the below steps.

## Prerequisites

Before you can begin testing our API, you’ll need to complete a few tasks:

1. Generate your temporary authorization token using our `/v2/auth/oauth2-token`.
Read more about the steps to generate the token in the [Authentication](/spotnana/authentication) page.
> **NOTE:** To run the authorization API, you’ll require the `client_id` and `client_secret`.
Contact your Spotnana account representative to retrieve these credentials.
2. Review the request schema of every endpoint before testing it.
Some API endpoints may require mandatory parameters within the request body to access the API.
These mandatory parameters are marked as **required** within the schema.
3. The `User-Agent` header is mandatory for all API requests.
Make sure you've included the `User-Agent` header in your code before initiating an API request.


## Steps to test an API

To test an API from the documentation:

1. Open any endpoint from the list of APIs available on this documentation site.
2. Click **Try It** on the right-hand side (next to the endpoint URL).


![Required Parameters](/assets/try-it-option2.3961b336ce89c3993a1e21795a653c143bea93e07c0921c0e49e88a1e0dd343a.9c1bb791.png)
*Fig: The Try It option in the documentation.*

1. Enter your authorization credentials.
2. Enter the required request body parameters (if any).
3. Click **Send**.


A response code of `200` indicates the request has been successful.
However, if you receive any 4xx error response code, re-check your request body and authorization credentials and try again.
To learn more about the error codes refer to the [error handling](/spotnana/error_handling) page.