---
title: "List sources with metrics"
method: GET
path: "/api/v1/sources"
tags: ["v1"]
---

# List sources with metrics

`GET /api/v1/sources`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/v1/sources`
- Auth: HTTP bearer

## Query parameters

- `period` '7' | '30' | 'all'

## Response `200`

Sources

- V1SourcesResponse
  - `data` V1Source[], required
    - `id` string, required
    - `type` string, nullable, required
    - `linkedinUrl` string, nullable, required
    - `displayName` string, nullable, required
    - `isActive` boolean, nullable, required
    - `strengthScore` number, nullable, required
    - `signalCount` number, nullable, required
    - `totalPosts` number, nullable, required
    - `qualifiedPosts` number, nullable, required
    - `creditUsage` SourceCreditUsage, required: Credits the source spent and signals it produced over the last 7 and 30 days (rolling windows ending now, the same windows as signalCount with period 7 and 30)
      - `last7Days` object, required
        - `credits` number, required
        - `signals` integer, required
        - `creditsPerSignal` number, nullable, required: null when there was no signal
      - `last30Days` object, required
        - `credits` number, required
        - `signals` integer, required
        - `creditsPerSignal` number, nullable, required: null when there was no signal
    - `createdAt` string, nullable, required
  - `total` number, required
  - `_meta` V1Meta, required
    - `mode` 'live' | 'sample', required
    - `notice` string
    - `cta` object
      - `text` string, required
      - `url` string, required

## Other responses

- `401`: Unauthorized
- `403`: Insufficient scope

---

[API](https://skmtc.dev/signalraven/apis/zygnal-api.md) · [All operations](https://skmtc.dev/signalraven/apis/zygnal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalraven/apis/zygnal-api/revisions/36e1d9b9d604?raw)