# 6. Make your first REST API call

evalink talos REST API supports [OAuth 2.0](https://oauth.net/2/) protocol to authorize and authenticate API calls.

You can find all the endpoints for the evalink talos API in the following link:

[**https://docs.talos-app.io/**](https://docs.talos-app.io/)

**evalink talos – Endpoint Documentation** 

To login, please use the following credentials:

username: `docs`

password: `v)n\cm(.B'JO{FO#8ZxFzH/xj1EBv<%2`

#### How to authorize against the evalink talos API:

1. Find the **API** Token that you have created in your evalink talos account following [5. Create an API Token in evalink talos](https://app.gitbook.com/@sitasys-ag/s/evalink-talos/~/drafts/-M_dxe2g6-x5VzLCswrb/get-started/rest-basics/@drafts).&#x20;
2. To send your first API request, open **Postman**.                                                                           Click the **+** plus button to open a new tab.&#x20;

   When using the “**New**” button, you will be asked to give your request a name and description. Choose/create a collection to save it in. **Save** to create your request.
3. Select the kind of request you want to use by clicking on the request “**Get**”.

<div align="center"><img src="/files/-M_eKOp9cMZgsotxpkUl" alt=""></div>

&#x20;       (Not sure ? Review basic terminology about REST on  [3. About REST - The Basics](/evalink-talos/get-started/rest-basics-1.md))

&#x20;&#x34;**.** If your goal is to GET a list of all the devices (sites) for your evalink talos tenant, you need to submit the following API request:

## get devices by companyID

<mark style="color:blue;">`GET`</mark> `https://talos.evalink.io/api/device-service/devices/search/findByCompanyId`

This request will provide you a list of devices (sites) for a particular company ID.

#### Query Parameters

| Name      | Type   | Description                                                                         |
| --------- | ------ | ----------------------------------------------------------------------------------- |
| CompanyID | string | Your evalink talos CompanyID, as it is displayed in the evalink talos Web Interface |

#### Headers

| Name          | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| Authorization | string | Use 'Bearer' followed by your API Token |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

4\.   Then add your evalink talos **API Token**  to the “**Headers**” in the request with the following Key-Value Pair:

**`Key: Authorization`**\
**`Value: Bearer <API_TOKEN>`**

![](/files/-M_eY0QFX1wahBeujp8C)

The evalink talos API is constructed in a way that API Requests will frequently need the Company ID as a ( parameter.&#x20;

5\.    Click on 'Send' to submit your request to the evalink talos API.

For further guidance, please also see:&#x20;

* <https://learning.postman.com/docs/getting-started/sending-the-first-request/>&#x20;
* <https://learning.postman.com/docs/sending-requests/requests/>


---

# 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://sitasys-ag.gitbook.io/evalink-talos/get-started/6.make-a-rest-api-call.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.