Quickstart Guide
Get up and running with CTWiseAPI in 5 minutes.
Watch the Demo​
Prerequisites​
- An AWS account (for Marketplace subscription)
- A REST API client (curl, Postman, etc.)
Step 1: Subscribe on AWS Marketplace​
- Visit CTWiseAPI on AWS Marketplace
- Click "View purchase options"
- Select your tier (Free or Starter)
- Complete the subscription process
Free Tier
The Free tier includes 1,000 API calls per month at no cost. Perfect for evaluation!
Step 2: Get Your API Key​
After subscribing:
- You'll be redirected to app.orchestraprime.ai
- Create your account or sign in
- Navigate to Settings → API Keys
- Click "Create New API Key"
- Copy and save your API key securely
Keep Your Key Secret
Your API key grants access to your account. Never share it publicly or commit it to version control.
Step 3: Make Your First API Call​
Using cURL​
curl -X POST https://api.ctwise.ai/v1/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "informed consent requirements",
"sources": ["FDA", "ICH"],
"limit": 5
}'
Using Python​
import requests
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.ctwise.ai/v1"
response = requests.post(
f"{BASE_URL}/search",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
},
json={
"query": "informed consent requirements",
"sources": ["FDA", "ICH"],
"limit": 5
}
)
results = response.json()
for rule in results["rules"]:
print(f"• {rule['title']} (Score: {rule['confidence']})")
Using JavaScript/Node.js​
const response = await fetch('https://api.ctwise.ai/v1/search', {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
query: 'informed consent requirements',
sources: ['FDA', 'ICH'],
limit: 5
})
});
const results = await response.json();
results.rules.forEach(rule => {
console.log(`• ${rule.title} (Score: ${rule.confidence})`);
});
Step 4: Understand the Response​
{
"query": "informed consent requirements",
"totalResults": 47,
"returnedResults": 5,
"rules": [
{
"ruleId": "rule_fda_001",
"title": "21 CFR 50.25 - Elements of Informed Consent",
"summary": "Basic elements required for informed consent in clinical research...",
"source": "FDA",
"documentType": "Regulation",
"confidence": 0.95,
"evidenceChain": [
"21 CFR Part 50 - Protection of Human Subjects",
"Subpart B - Informed Consent of Human Subjects"
],
"lastUpdated": "2024-01-15"
}
// ... more results
],
"processingTimeMs": 245
}
Response Fields​
| Field | Description |
|---|---|
totalResults | Total matching rules found |
returnedResults | Number of rules in this response |
rules | Array of matching regulatory rules |
confidence | AI-generated relevance score (0-1) |
evidenceChain | Document hierarchy trace |
What's Next?​
- Authentication Guide - Learn about API key management
- API Reference - Explore all endpoints
- Rate Limits - Understand usage limits
- SDKs - Use our official client libraries