List Signals

Retrieve regulatory and industry signals with AI-powered analysis.

GET /v1/signals

cURL

curl -X GET "https://api.medstrato.com/v1/signals?source=fda&impact=high&per_page=10" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

{
  "data": [
    {
      "id": "sig_abc123",
      "title": "FDA Issues Updated Guidance on AI/ML-Based Medical Devices",
      "url": "https://www.fda.gov/medical-devices/...",
      "source": {
        "name": "FDA",
        "country": "US",
        "region": "North America"
      },
      "ai_summary": "The FDA has released updated guidance clarifying the regulatory pathway for AI/ML-based medical devices, emphasizing the importance of continuous learning algorithms and predetermined change control plans.",
      "impact": {
        "level": "high",
        "score": 85,
        "categories": ["regulatory", "ai_ml", "software"]
      },
      "sentiment": "neutral",
      "product_relevance": [
        {
          "product_id": "prod_xyz789",
          "product_name": "CardioAI Diagnostic System",
          "relevance_type": "direct",
          "relevance_score": 0.92
        }
      ],
      "is_read": false,
      "is_bookmarked": false,
      "published_at": "2024-01-18T16:00:00Z",
      "fetched_at": "2024-01-18T18:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 10,
    "total": 23,
    "unread_count": 8
  }
}

Query Parameters

page · integer · default: "1"

Page number

per_page · integer · default: "20"

Results per page (max 100)

source · string

Filter by source. Options: fda, ema, nmpa, pmda, tga, health_canada, mhra, industry

impact · string

Filter by impact level. Options: critical, high, medium, low

sentiment · string

Filter by sentiment. Options: positive, neutral, negative

product_id · string

Filter signals relevant to a specific product

is_bookmarked · boolean

Filter bookmarked signals only

is_read · boolean

Filter by read/unread status

search · string

Full-text search in title and content

published_after · string

Filter signals published after this date (ISO 8601)

Response

data · array

Show Signal object

id · string

Unique identifier

title · string

Signal title

url · string

Source URL

source · object

Source details (name, country, region)

content · string

Full content text

ai_summary · string

AI-generated summary

impact · object

Show Impact assessment

level · string

Impact level (critical, high, medium, low)

score · number

Impact score (0-100)

categories · array

Affected categories

sentiment · string

Sentiment (positive, neutral, negative)

product_relevance · array

Relevant products with relevance type

is_read · boolean

Read status

is_bookmarked · boolean

Bookmark status

published_at · string

Publication timestamp

fetched_at · string

Fetch timestamp

cURL

curl -X GET "https://api.medstrato.com/v1/signals?source=fda&impact=high&per_page=10" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

{
  "data": [
    {
      "id": "sig_abc123",
      "title": "FDA Issues Updated Guidance on AI/ML-Based Medical Devices",
      "url": "https://www.fda.gov/medical-devices/...",
      "source": {
        "name": "FDA",
        "country": "US",
        "region": "North America"
      },
      "ai_summary": "The FDA has released updated guidance clarifying the regulatory pathway for AI/ML-based medical devices, emphasizing the importance of continuous learning algorithms and predetermined change control plans.",
      "impact": {
        "level": "high",
        "score": 85,
        "categories": ["regulatory", "ai_ml", "software"]
      },
      "sentiment": "neutral",
      "product_relevance": [
        {
          "product_id": "prod_xyz789",
          "product_name": "CardioAI Diagnostic System",
          "relevance_type": "direct",
          "relevance_score": 0.92
        }
      ],
      "is_read": false,
      "is_bookmarked": false,
      "published_at": "2024-01-18T16:00:00Z",
      "fetched_at": "2024-01-18T18:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 10,
    "total": 23,
    "unread_count": 8
  }
}