# Search for Existing Calls

## ASM API Quick Reference Guide <a href="#asmapiquickreferenceguide" id="asmapiquickreferenceguide"></a>

### Searching for Existing Calls <a href="#searchingforexistingcalls" id="searchingforexistingcalls"></a>

1. In Postman, select 'New' in the top left-hand corner.&#x20;
2. Select HTTP from the dialogue window and give the request the name of **Get Call List**

<figure><img src="/files/SRD5kBPOXU765GPrRtK3" alt=""><figcaption></figcaption></figure>

3. Set the method to Get and the URL will be as follows, you have two options:

   Option 1: use the system variable for your base system url: `{{SystemURLTest}}/alemba.api/api/v2/call`

   Option 2: write the full base url: `https://<yourservername>/<yourasmsystemname>/alemba.api/api/v2/call`
4. Click the Authorization tab.
5. Set **Type** as **No Auth**

<figure><img src="/files/XPJ1TftNwrlu60jTksd6" alt=""><figcaption></figcaption></figure>

6. Click **Headers** and add the following lines

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Key</td><td valign="top">Value</td></tr><tr><td valign="top">Content-Type</td><td valign="top">Application/json</td></tr><tr><td valign="top">Authorization</td><td valign="top">Bearer {{Login_Token}}</td></tr></tbody></table>

{% hint style="danger" %}

1. **{{Login\_Token}}** is the name of the environment variable we created earlier. This can be replaced with the actual access\_token value obtained, e.g. Bearer awerff32h347hb4tgb34&#x20;

2. The space between Bearer and the {{Login\_Token}}/access\_token is intentional and REQUIRED
   {% endhint %}

3. Verify the Headers tab appears as follows

<figure><img src="/files/OqHLmKehtOd2l0ZafK5i" alt=""><figcaption></figcaption></figure>

8. Send the request to get a list of calls.  You will get a “results” array as per below. An array is a list of objects in JSON

<figure><img src="/files/NNic0pS5JUmxbiLNmfZy" alt=""><figcaption></figcaption></figure>

OPTIONAL: You can now make a note of a call number from the result and update the CallRef variable by&#x20;

1. Access Environments on left hand menu
2. Select your Environment&#x20;
3. Fill a Current Value for Call Ref, as per below:

<figure><img src="/files/CgiMOyXmHsS87KB4NW6k" alt=""><figcaption></figcaption></figure>

4. Click save in the top right hand corner of your screen, to save the new variable

<figure><img src="/files/oI0hTeDYH2eahnekWOER" alt=""><figcaption></figcaption></figure>


---

# 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.alemba.com/asm-hermes/integrate/apis/asm-api-quick-reference-guide/search-for-existing-calls.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.
