API Documentation

Build integrations with iS&T Dashboard using our REST API

Authentication

API Keys
All API requests require authentication using an API key

Include your API key in the Authorization header of every request:

Authorization: Bearer YOUR_API_KEY

Get your API key from your account settings. Keep it secret and never commit it to version control.

Endpoints

POST

/api/surveys

Create Survey

GET

/api/surveys/:id/responses

Get Survey Responses

POST

/api/surveys/:id/responses

Submit Survey Response

GET

/api/surveys/:id/analytics

Get Survey Analytics

POST

/api/reports/generate

Generate Report

Code Examples

Python
import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.soomtech.com"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Create a survey
survey_data = {
    "title": "R&D Investment Priorities",
    "description": "Understanding research priorities",
    "topic": "Science and technology funding"
}

response = requests.post(
    f"{BASE_URL}/api/surveys",
    json=survey_data,
    headers=headers
)

survey = response.json()
print(f"Survey created: {survey['id']}")
JavaScript
const API_KEY = "your_api_key_here";
const BASE_URL = "https://api.soomtech.com";

async function createSurvey() {
  const surveyData = {
    title: "R&D Investment Priorities",
    description: "Understanding research priorities",
    topic: "Science and technology funding"
  };

  const response = await fetch(`${BASE_URL}/api/surveys`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(surveyData)
  });

  const survey = await response.json();
  console.log(`Survey created: ${survey.id}`);
  return survey;
}

createSurvey();

Rate Limiting

Starter Plan

1,000 requests per hour

Professional Plan

10,000 requests per hour

Enterprise Plan

Unlimited requests (custom limits available)

Need Help?

Check our documentation or contact our API support team.