Skip to content
Median
Esc
↑↓navigate↵open⌘Jpreview

List signals

One kind’s list, most recently moved first, up to 60. filter defaults to live: everything not yet done or declined.

GET/signals
Authorization
AuthorizationBearer token · headerrequired
`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.
Query parameters
kindstringrequired
Allowed:bugsuggestion
filterstring
Allowed:liveallopenplannedin progressin reviewdonedeclined
Responses
200The signals.
signalsSignal[]
Show properties
Array of Signal
idstring
kindstring
Allowed:bugsuggestion
titlestring
bodystring
prioritystring
Allowed:urgenthighmediumlow
statusstring
Allowed:openplannedin progressin reviewdonedeclined
reporterCountinteger
aliasesstring[]
The other titles this was reported under, kept when duplicates merge.
filedAtinteger
updatedAtinteger
updatedByNamestring | null
linearobject | null
Show properties
identifierstring
urlstring
githubobject | null
Show properties
numberinteger
urlstring
400The request is malformed, and the message names the field.
errorobject
Show properties
codestring
messagestring
401The bearer token is missing, revoked, or expired.
errorobject
Show properties
codestring
messagestring
429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).
errorobject
Show properties
codestring
messagestring
Request
curl -X GET "https://api.median.sh/v1/signals?kind=bug" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "signals": [
    {
      "id": "string",
      "kind": "bug",
      "title": "string",
      "body": "string",
      "priority": "urgent",
      "status": "open",
      "reporterCount": 0,
      "aliases": [
        "string"
      ],
      "filedAt": 0,
      "updatedAt": 0,
      "updatedByName": "string",
      "linear": {
        "identifier": "string",
        "url": "string"
      },
      "github": {
        "number": 0,
        "url": "string"
      }
    }
  ]
}