Skip to main content
GET
/
api
/
v1
/
signals
/
types
List signal types
curl --request GET \
  --url https://app.puffle.ai/api/v1/signals/types \
  --header 'Authorization: Bearer <token>'
{
  "signal_types": [
    {
      "id": "aaaa1111-1111-1111-1111-111111111111",
      "label": "hiring",
      "description": "Companies posting roles matching your target profile",
      "kind": "structured",
      "enabled": true,
      "keywords": [
        "software engineer",
        "backend"
      ],
      "disqualifiers": [
        "internship",
        "contractor"
      ],
      "config": {
        "roles": [
          "Software Engineer",
          "Backend Engineer"
        ],
        "seniority": [
          "Senior",
          "Director"
        ],
        "work_type": "Any",
        "locations": [
          "United States"
        ]
      },
      "config_schema": {
        "type": "object",
        "properties": {
          "roles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "built_in": true,
      "search_instructions": "Find job postings that mention...",
      "scoring_criteria": "Score higher when the role is senior...",
      "sources": [
        "linkedin_jobs"
      ]
    }
  ]
}

​
Overview

Return every signal type (built-in and user-created) for the authenticated partner, ordered by position. Built-in types (hiring, funding, management_change, competitor_mentions) come pre-seeded; additional keyword types are created via POST /api/v1/signals/types. This is the public partner API — rate-limited at 100 req/min.
This operation shares the URL path /api/v1/signals/types with other verbs. See the sibling page for related operations on the same resource.

Authorizations

​
Authorization
string
header
required

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

Response

Array of signal types.

​
signal_types
object[]
required