List signals | Middesk

curl https://api.middesk.com/v1/signals \
     -H "Authorization: Bearer <token>"

{
  "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

total_countinteger

$	curl https://api.middesk.com/v1/signals \
>	-H "Authorization: Bearer <token>"

1	{
2	"object": "list",
3	"has_more": true,
4	"data": [
5	{
6	"object": "signal",
7	"id": "f6a7b8c9-d0e1-2345-f012-3456789abcde",
8	"name": "Acme Corporation",
9	"created_at": "2025-01-07T12:00:00Z",
10	"tin": "12-3456789",
11	"external_id": "ext-12345",
12	"model_slug": "verify",
13	"score": 0.85,
14	"batch_id": "a7b8c9d0-e1f2-3456-0123-456789abcdef",
15	"requester": {
16	"id": "b8c9d0e1-f2a3-4567-1234-56789abcdef0",
17	"type": "Account",
18	"name": "Example Account"
19	},
20	"reasons": [
21	{
22	"category": "identification",
23	"group": "name",
24	"description": "Business name verified",
25	"code": "V101"
26	}
27	],
28	"addresses": [
29	"123 Main Street, San Francisco, CA 94105"
30	],
31	"people": [
32	"people"
33	]
34	}
35	],
36	"total_count": 1
37	}