Field Values

Reusable enum and filter values used across the API: industry sizes, job levels, signal types, country codes.

Tip: Use this to populate dropdowns and validation in your UI, instead of hard-coding the allowed values.

Endpoint

GET /api/v1/meta/field-values

Authentication

All requests require the X-Satellyte-API-Key header. See Quickstart.

Request

No body or query parameters.

cURL

curl -i "https://api-staging.satellyte.ai/api/v1/meta/field-values" \
  -H "X-Satellyte-API-Key: $API_KEY"

Response (200)

{
  "data": {
    "lead_statuses": ["detected", "queued_comment", "commented", "queued_connect", "connection_sent", "connected", "queued_message", "messaged", "replied", "meeting_booked", "not_interested", "connection_withdrawn", "skipped", "blocked"],
    "signal_types": ["keyword_post", "keyword_comment", "competitor_engagement", "influencer_engagement", "asking_for_recommendations", "job_change", "company_hiring", "funding_announcement", "event_rsvp"],
    "employee_ranges": ["1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+"],
    "job_levels": ["Founder", "CXO", "VP", "Director", "Head", "Manager", "IC"],
    "job_functions": ["Sales", "Marketing", "Growth", "Revenue", "Operations", "RevOps", "Product", "Engineering", "People", "Finance", "Customer Success", "Partnerships"],
    "countries": {
      "global": "WORLD",
      "recommended_examples": ["WORLD", "US", "SG", "GB", "AU", "CA", "ID"],
      "format": "ISO 3166-1 alpha-2 country code"
    },
    "public_api_feedback_event_types": ["open", "click", "reply", "positive_reply", "bounce", "meeting_booked"],
    "outreach_destinations": ["heyreach", "instantly", "webhook_url"],
    "search_logic": {
      "field_groups": "AND",
      "values_inside_same_field": "OR",
      "exclude_filters": "NOT",
      "global_location": "WORLD"
    },
    "endpoint_groups": {
      "discover": ["POST /api/v1/discover/companies", "POST /api/v1/discover/people"],
      "signals": ["GET /api/v1/signals/hiring", "GET /api/v1/signals/funding"]
    },
    "generated_at": "2026-05-11T07:52:00.000Z"
  }
}

Response fields

FieldTypeNotes
lead_statusesstring[]Allowed lead state values.
signal_typesstring[]Allowed signal types.
employee_rangesstring[]Allowed company size buckets.
job_levelsstring[]Filter values for people search.
job_functionsstring[]Filter values for people search.
countriesobjectCountry-code conventions and recommended examples.
public_api_feedback_event_typesstring[]Allowed values for /feedback/events.event_type.
outreach_destinationsstring[]Allowed values for /leads/push.destination.
search_logicobjectHow filters combine (AND, OR, NOT, sentinels).
endpoint_groupsobjectEndpoint catalog grouped by product area.