# Access Tokens

Masters India supports access-token-based authentication. After a user login request, our API generates an access\_token and a refresh token to a user after validating his credentials. 

### Access Token

The Access token key can be used in subsequent requests but expires after 24 hours which must be requested again by re-initiating a login or calling the token-refresh API. 

The Access token once generated is valid for 24 hours and the refresh token is valid for many days. This token needs to be passed in the subsequent requests to avoid permission issues.

The key needs to be passed as a request parameter. To generate the Authorization token by clicking on the Send button. Once the Token Is generated. We need to the token in **Authorization** header with the prefix **JWT** so the token will be passed as **JWT \<token>**

## Get Access token API

### Request Method

POST

### Request Path

```
{{API_URL}}/api/v1/token-auth/
```

### Request Body

| Parameter | Value        | Description                |
| --------- | ------------ | -------------------------- |
| username  | sample\_user | username                   |
| password  | 1234Pass     | password of the given user |

### Response Body

#### 200 (OK)

| Parameter | Value | Description                   |
| --------- | ----- | ----------------------------- |
| token     | ''    | access token (24 hr validity) |

#### 206 (Invalid Credentials)

| Parameter | Value                                      | Description |
| --------- | ------------------------------------------ | ----------- |
| error     | "Unable to login with provided credential" |             |

#### 400 (Invalid Params)

| Parameter | Value              | Description |
| --------- | ------------------ | ----------- |
| username  | \['missing field'] |             |
|           |                    |             |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mastersindia.co/einvoicing/authentication/access-tokens.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.