# Astera's Server API Documentation

**Authentication**

Astera's Server APIs use *Bearer Token* authentication. To learn more about authenticating Astera's Server APIs, click [here](/astera-data-stack-v9/api-flows/api-consumption/authorize/authorizing-asteras-server-apis.md).

**Resource: Account**

**Login**

Method: POST

Endpoint: https\://{servername}:{portno}/api/account/login

In this case: <https://LOCALHOST:9261/api/account/login>

Resource: /api/account/login

**Request Body**

{% hint style="info" %}
**Note**: The format of our request body is JSON type.
{% endhint %}

| **Fields** | **Field** **Location** | **Data Type** | **Description**                                | **JSON Format**                                                     |
| ---------- | ---------------------- | ------------- | ---------------------------------------------- | ------------------------------------------------------------------- |
| User       | Body                   | String        | Username of the Astera user account.           | { "user": "admin", "password": "Admin123", "rememberMe": **true** } |
| Password   | Body                   | String        | Password of the Astera user account.           |                                                                     |
| RememberMe | Body                   | Boolean       | Binary value. Pass “1” for yes and “0” for no. |                                                                     |

**Resource: Job**

**Status**

Method: GET

Endpoint: <https://LOCALHOST:9261/api/Job/{jobID}/Status>

Resource: /api/Job/{jobID}/Status

**Required Parameter**

| **Parameter** | **Parameter Location** | **Data Type** | **Description**                                              |
| ------------- | ---------------------- | ------------- | ------------------------------------------------------------ |
| JobID         | URI                    | Integer       | Job ID of the flow that has already been executed in Astera. |

Description: This method fetches the status of a job for the given job ID. A few of the response statuses are given below:

1. Unknown
2. Invalid
3. NotStarted
4. Queued
5. Initializing
6. Running
7. Completed


---

# 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://documentation.astera.com/astera-data-stack-v9/api-flows/api-consumption/authorize/asteras-server-api-documentation.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.
