---
title: Inquiries API
description: Step-by-step guide to using the Inquiries API to trigger automated calls, capture input, and manage inquiry data.
---

[Skip to content](https://support.maqsam.com/inquiries-api-#main-content)

- [English](https://support.maqsam.com/inquiries-api-)
- [العربية](https://support.maqsam.com/ar/inquiries-api)

English

Show submenu for translations

[![maqsam](https://support.maqsam.com/hs-fs/hubfs/maqsam-logo-en-1.png?width=170&height=40&name=maqsam-logo-en-1.png)](https://support.maqsam.com?hsLang=en)

Open main navigation

Close main navigation

- - [English](https://support.maqsam.com/inquiries-api-)
    - [العربية](https://support.maqsam.com/ar/inquiries-api)

  English
  
  Show submenu for translations

 Welcome to Maqsam

- There are no suggestions because the search field is empty.

1. [Welcome to Maqsam](https://support.maqsam.com/?hsLang=en)
2. [Voice](https://support.maqsam.com/voice?hsLang=en)
3. [📞 All Voice Features](https://support.maqsam.com/voice?hsLang=en#all-voice-features)

# Inquiries API

## Trigger automated calls, capture recipient input, and access detailed call data using Maqsam’s Inquiries API.

### 🔍 **Overview of Inquiries API**

With the Inquiries API, you can trigger automated outgoing calls that play the audio file of your choice and capture the recipient’s input. Once the call ends, our servers return all the data related to each call to the callback URL you set.

This page also allows you to filter inquiries calls and export your inquiry data.

---

### 💡 **Key Details**

**The Inquiries tab will include the below information:**

- **ID:** Unique identifier for each inquiry call.
- **Created:** Timestamp of the call.
- **State:** Status of the call (e.g., Terminated = successfully initiated).
- **To:** Phone number of the contacted client.
- **Entries:** IVR input from the recipient.
- **Trials:** Number of retries before aborting the call.
- **Duration:** Total time of the call.
- **Call State:** Stage of the call (Initialized, Awaiting Connect, Awaiting Entry, Closing, Terminated).
- **Recording:** Audio recording of the call.

**The filter tab will include the below information:**

- **Call States:** Filter calls based on their state (Initialized, Awaiting Connect, Awaiting Entry, Closing, Terminated).
- **To:** Search by client phone number.
- **Date Range:** Filter calls within a specific time period.

---

### ⚙️ How to Create Inquiries

Follow the steps below to enable and set up the Inquiries API on your account:

1. Contact Support:
   
     - Reach out to support@maqsam.com to enable API access on your account.
2. Generate API Credentials:
   
     - Go to **Account Settings, API Credentials , then Generate API Key.**
     - Generate API key to generate your |access\_key\_id| and |access\_secret|.
     - Use these credentials on your platform (website/CRM) to set up inquiries.
3. Implement API:
   
     - Follow the implementation instructions in the Inquiries API according to the [documentation](https://portal.maqsam.com/docs/v1/inquiries).

📌 **Note**: Ensure your technical team thoroughly reviews the documentation to verify full implementation.

- [Getting Started](https://support.maqsam.com/getting-started?hsLang=en)
- [Administration](https://support.maqsam.com/administration?hsLang=en#main-content)

    - [💳 Billing & Payments](https://support.maqsam.com/administration?hsLang=en#billing-payments)
    - [⚙️ Account Settings](https://support.maqsam.com/administration?hsLang=en#%EF%B8%8F-account-settings)
- [Voice](https://support.maqsam.com/voice?hsLang=en#main-content)

    - [🔀 IVR Builder](https://support.maqsam.com/voice?hsLang=en#ivr-builder)
    - [📞 All Voice Features](https://support.maqsam.com/voice?hsLang=en#all-voice-features)
- [Messaging](https://support.maqsam.com/messaging?hsLang=en#main-content)

    - [💬 WhatsApp](https://support.maqsam.com/messaging?hsLang=en#whatsapp)
- [Integrations](https://support.maqsam.com/integrations?hsLang=en#main-content)

    - [🔌 HubSpot Integration](https://support.maqsam.com/integrations?hsLang=en#hubspot-integration)
    - [🔌 Pipedrive Integration](https://support.maqsam.com/integrations?hsLang=en#pipedrive-integration)
    - [🔌 Intercom Integrtion](https://support.maqsam.com/integrations?hsLang=en#intercom-integrtion)
    - [🔌 Zendesk Integration](https://support.maqsam.com/integrations?hsLang=en#zendesk-integration)
    - [🔌 FreshDesk Integration](https://support.maqsam.com/integrations?hsLang=en#freshdesk-integration)
    - [🔌 Salesloft Integration](https://support.maqsam.com/integrations?hsLang=en#salesloft-integration)
    - [🔌 Salesforce Integration](https://support.maqsam.com/integrations?hsLang=en#salesforce-integration)
    - [🔌 Zoho Phonebridge Integration](https://support.maqsam.com/integrations?hsLang=en#zoho-phonebridge-integration)
- [Artificial Intelligence](https://support.maqsam.com/artificial-intelligence?hsLang=en#main-content)

    - [AI Agent Studio](https://support.maqsam.com/artificial-intelligence?hsLang=en#ai-agent-studio)
- [Reports](https://support.maqsam.com/reports?hsLang=en)
- [Legal & Compliance](https://support.maqsam.com/legal-compliance?hsLang=en)
- [FAQs](https://support.maqsam.com/faqs?hsLang=en#main-content)

    - [🔌 Integrations](https://support.maqsam.com/faqs?hsLang=en#integrations)
    - [⚙️ Accounts](https://support.maqsam.com/faqs?hsLang=en#%EF%B8%8F-accounts)
    - [💬 Messaging](https://support.maqsam.com/faqs?hsLang=en#messaging)
    - [💳 Payments](https://support.maqsam.com/faqs?hsLang=en#payments)
    - [📞 Voice](https://support.maqsam.com/faqs?hsLang=en#voice)
    - [✅ Troubleshooting](https://support.maqsam.com/faqs?hsLang=en#troubleshooting)

[![maqsam](https://support.maqsam.com/hs-fs/hubfs/maqsam-logo-en-1.png?width=170&height=40&name=maqsam-logo-en-1.png "maqsam")](https://maqsam.com/)

<https://www.instagram.com/maqsamhq/> <https://www.facebook.com/maqsamhq/> <https://twitter.com/maqsamhq> <https://www.linkedin.com/company/maqsamhq/> <https://www.youtube.com/@maqsamhq?si=_3jk9TLGhkzI7FLm> <https://www.tiktok.com/@maqsamhq>

Copyright © 2026, Maqsam