List signals | Middesk

import requests
url = "https://api.middesk.com/v1/signals"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "object": "list",
  "has_more": true,
  "data": [
    {
      "object": "signal",
      "id": "f6a7b8c9-d0e1-2345-f012-3456789abcde",
      "name": "Acme Corporation",
      "created_at": "2025-01-07T12:00:00Z",
      "tin": "12-3456789",
      "external_id": "ext-12345",
      "model_slug": "verify",
      "score": 0.85,
      "batch_id": "a7b8c9d0-e1f2-3456-0123-456789abcdef",
      "requester": {
        "id": "b8c9d0e1-f2a3-4567-1234-56789abcdef0",
        "type": "Account",
        "name": "Example Account"
      },
      "reasons": [
        {
          "category": "identification",
          "group": "name",
          "description": "Business name verified",
          "code": "V101"
        }
      ],
      "addresses": [
        "123 Main Street, San Francisco, CA 94105"
      ],
      "people": [
        "people"
      ]
    }
  ],
  "total_count": 1
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

pageintegerOptional

Page number

per_pageintegerOptional

Items per page

qstringOptional

Search query

external_idstringOptional

Filter by external ID

start_datestringOptional

Start date filter (YYYY-MM-DD)

end_datestringOptional

End date filter (YYYY-MM-DD)

starting_atstringOptional

Start timestamp filter

ending_atstringOptional

End timestamp filter

batch_idstringOptional

Filter by batch ID

model_slugstringOptional

Filter by model slug

reason_codesstringOptional

Filter by reason codes

Response

signals list

objectstring

has_moreboolean

datalist of objects or null

total_countinteger or null