> For the complete documentation index, see [llms.txt](https://sitasys-ag.gitbook.io/evalink-talos/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sitasys-ag.gitbook.io/evalink-talos/get-started/6.make-a-rest-api-call.md).

# 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/>