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

Field	Type	Notes
`lead_statuses`	string[]	Allowed lead state values.
`signal_types`	string[]	Allowed signal types.
`employee_ranges`	string[]	Allowed company size buckets.
`job_levels`	string[]	Filter values for people search.
`job_functions`	string[]	Filter values for people search.
`countries`	object	Country-code conventions and recommended examples.
`public_api_feedback_event_types`	string[]	Allowed values for `/feedback/events.event_type`.
`outreach_destinations`	string[]	Allowed values for `/leads/push.destination`.
`search_logic`	object	How filters combine (AND, OR, NOT, sentinels).
`endpoint_groups`	object	Endpoint catalog grouped by product area.

Error responses

All failed calls use the standard error envelope documented in Errors.

Status	Code	Notes
`401`	`unauthorized`	Returned when `X-Satellyte-API-Key` is missing, invalid, or expired.
`404`	`not_found`	Returned when Public API access is not enabled or the field values resource is unavailable.
`429`	`rate_limit_exceeded`	Returned when the API key exceeds its configured rate limit.
`500`	`service_error`	Returned when Satellyte cannot load reusable field values. Retry with backoff.