---
title: "List Webhook Events"
method: GET
path: "/v0/webhooks/{webhook_id}/events"
tags: ["Webhooks"]
---

# List Webhook Events

`GET /v0/webhooks/{webhook_id}/events`

Retrieve a paginated list of all events triggered for a specific webhook including delivery status, payload, and timestamps. Filter by event status to find failed deliveries that may need to be retried.

## Path parameters

- `webhook_id` integer, required — ID of the webhook

## Query parameters

- `status` 'IN_PROGRESS' | 'SUCCESS' | 'FAILED' | 'NOT_TRIGGERED'
- `offset` integer — Number of results to skip
- `limit` integer — Number of results per page

## Response `200`

Successful Response

- WebhookEvent[]
  - `id` integer, required
  - `webhook_id` integer, required
  - `job_id` integer, nullable
  - `company_name` string, nullable
  - `event_type` string, required
  - `triggered_at` string, date-time, required
  - `status` 'IN_PROGRESS' | 'SUCCESS' | 'FAILED' | 'NOT_TRIGGERED', required
  - `payload` union
    - JobWithMatchingPhrasesResponseOutput
      - `id` integer, required — ID of the job
      - `job_title` string, required — Job title
      - `url` string, required — URL of the job post
      - `date_posted` string, date, required — Date when the job was posted
      - `has_blurred_data` boolean — Whether the returned object has company identifiable data blurred or not
      - `company` string, required — Company name. This field is deprecated, please don't use it
      - `final_url` string, nullable — Is the URL of the job in the career page of the company.
      - `source_url` string, required — Is the url TheirStack used to get the job data.
      - `location` string, nullable — This is the city of the job.
      - `short_location` string, nullable — It's a combination of the city and the state of the job.
      - `long_location` string, nullable — It's a combination of the city, the state and the postal code of the job.
      - `state_code` string, nullable — The state code of the job.
      - `latitude` number, nullable — The latitude of the job.
      - `longitude` number, nullable — The longitude of the job.
      - `postal_code` string, nullable — The postal code of the job.
      - `remote` boolean, nullable — If the job is remote.
      - `hybrid` boolean, nullable — If the job is hybrid. A hybrid position is a job that combines remote and in-office work.
      - `salary_string` string, nullable — The salary of the job in the local currency. If a similar field is present in the job source, this property will contain the same content. If no similar field is present, the content will be have the following format: <min_annual_salary> <currency> - <max_annual_salary> <currency> per year. For the currencies where the symbol precedes the digits, the format will be <currency> <min_annual_salary> - <currency> <max_annual_salary> per year. In these latter two cases, both the min and max annual salary are expressed in either k (for thousands) or M (for millions).
      - `min_annual_salary` integer, nullable — The minimum annual salary of the job in the local currency.
      - `min_annual_salary_usd` number, nullable — The minimum annual salary of the job in USD.
      - `max_annual_salary` integer, nullable — The maximum annual salary of the job in the local currency.
      - `max_annual_salary_usd` number, nullable — The maximum annual salary of the job in USD.
      - `avg_annual_salary_usd` number, nullable — This property calculates the average annual salary for a job in USD, based on the available minimum and maximum annual salary values (both already converted to USD): If both min_annual_salary_usd and max_annual_salary_usd are missing or zero, it returns None. If only the minimum is missing, it returns the maximum value. If only the maximum is missing, it returns the minimum value. If both are present, it returns the average of the two, rounded to two decimal places. This ensures the property always provides the best possible estimate of the average salary, even if only one bound is available.
      - `salary_currency` string, nullable — The currency of the salary of the job.
      - `countries` string[], nullable — Countries of the job
      - `country` string, nullable — Country name of the job
      - `country_codes` string[], nullable — Two-letter country codes (ISO 3166-1 alpha-2) representing the job's locations.
      - `country_code` string, nullable — Two-letter country code (ISO 3166-1 alpha-2) representing the job's location. If the job has multiple locations, the first one is returned.
      - `cities` string[], nullable — Cities of the job
      - `continents` string[], nullable — Continents of the job
      - `seniority` 'c_level' | 'staff' | 'senior' | 'junior' | 'mid_level'
      - `discovered_at` string, date-time, required — Date when the job was discovered by TheirStack
      - `closed_at` string, date-time, nullable — Datetime (UTC) at which TheirStack detected the job posting was closed by the source. `null` means the job is still considered open (or we don't know yet).
      - `company_domain` string, nullable — Company website domain
      - `hiring_team` PersonBase[], nullable — Hiring team who posted the job
        - `first_name` string, nullable — First name of the person
        - `full_name` string, nullable — Full name of the person
        - `linkedin_url` string, nullable — LinkedIn URL of the person
        - `role` string, nullable — Role of the person
        - `image_url` string, nullable — Image URL of the person
        - `thumbnail_url` string, nullable — Thumbnail URL of the person
      - `reposted` boolean, nullable — Indicates whether the employer has republished this job posting.
      - `date_reposted` string, date, nullable — Date when the job was reposted
      - `employment_statuses` Commitment[] — Employment statuses of the job
      - `easy_apply` boolean, nullable — Indicates whether the job application can be submitted directly through the job board (easy_apply=True) or requires redirecting to the company's website (easy_apply=False).
      - `technology_slugs` string[] — Slugs of the technologies found in the job title, description, or URL. This is a subset of keyword_slugs filtered to only technology-type keywords.
      - `keyword_slugs` string[] — Slugs of all keywords (technologies and buying intent topics) found in the job title, description, or URL.
      - `description` string, nullable — Job description in markdown format
      - `company_object` CompanyWithTechnologySlugs, required
        - `id` string, required — Company ID
        - `name` string, required — Company name
        - `domain` string, nullable — Company domain
        - `industry` string, nullable — Industry of the company
        - `country` string, nullable — Country of the company's HQ
        - `country_code` string, nullable — ISO2 country code. E.g. "US"
        - `employee_count` integer, nullable — Number of employees of the company
        - `logo` string, nullable — Stable CDN-hosted company logo URL suitable for display in applications
        - `num_jobs` integer — Number of jobs from this company in our database
        - `num_technologies` integer — Number of technologies mentioned in the jobs of this company
        - `num_keywords` integer — Number of distinct keywords (technologies + buying intent topics) found in this company's jobs
        - `num_buying_intent_topics` integer — Number of distinct buying intent topic keywords found in this company's jobs
        - `possible_domains` string[] — List of possible domains for the company
        - `url` string, nullable — Company domain. Same as the "domain" field. Will be deprecated in the future.
        - `industry_id` integer, nullable — Code of the industry. One of LinkedIn's Industry Codes V2 from https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2
        - `linkedin_url` string, nullable
        - `num_jobs_last_30_days` integer — Number of jobs from this company in our database posted in the last 30 days
        - `num_jobs_found` integer, nullable — When filtering companies by jobs, number of jobs found for this company
        - `yc_batch` string, nullable — If the company went through YC, this is its batch
        - `apollo_id` string, nullable — ID of the company in Apollo
        - `linkedin_id` string, nullable — ID of the company in LinkedIn
        - `url_source` string, nullable — Source of the company URL
        - `is_recruiting_agency` boolean, nullable — Is a recruiting agency
        - `founded_year` integer, nullable — Year the company was founded
        - `annual_revenue_usd` number, nullable — Annual revenue of the company in USD
        - `annual_revenue_usd_readable` string, nullable — Annual revenue of the company in USD, formated as an easily readable string
        - `total_funding_usd` integer, nullable — Funding of the company in USD
        - `last_funding_round_date` string, date, nullable — Date of the last funding round of the company
        - `last_funding_round_amount_readable` string, nullable — Amount of the last funding round of the company, formated as an easily readable string
        - `employee_count_range` string, nullable — Number range of employees at the company
        - `long_description` string, nullable — Short description of the company
        - `seo_description` string, nullable — SEO description of the company, extracted from their website
        - `city` string, nullable — City of the company's HQ
        - `postal_code` string, nullable — Postal code of the company's HQ
        - `company_keywords` string[], nullable — Company keywords, related to what the company does. Deprecated: use company_tags instead.
        - `company_tags` string[] — Company keywords, related to what the company does
        - `alexa_ranking` integer, nullable — Alexa ranking
        - `publicly_traded_symbol` string, nullable
        - `publicly_traded_exchange` string, nullable
        - `investors` string[], nullable — List of investors in this company
        - `funding_stage` 'angel' | 'convertible_note' | 'debt_financing' | 'equity_crowdfunding' | 'other' | 'private_equity' | 'seed' | 'series_a' | 'series_b' | 'series_c' | 'series_d' | 'series_e' | 'series_f' | 'series_g' | 'series_h' | 'venture_round_not_specified' | 'series_i' | 'series_j' | 'undisclosed' | 'series_unknown' | 'pre_seed' | 'post_ipo_secondary' | 'post_ipo_equity' | 'post_ipo_debt' | 'non_equity_assistance' | 'late_vc' | 'initial_coin_offering' | 'growth_equity_vc' | 'grant' | 'early_vc' | 'corporate_round' | 'secondary_market' | 'product_crowdfunding'
        - `has_blurred_data` boolean — Whether the returned object has company identifiable data blurred or not
        - `keyword_slugs` string[] — Slugs of all keywords (technologies and buying intent topics) found in this company's jobs
        - `technology_slugs` string[], nullable — Slugs of the technologies found in this company's jobs. This is a subset of keyword_slugs filtered to only technology-type keywords.
        - `technology_names` string[], nullable — Names of the technologies found to be used by the company
      - `locations` JobLocationOutput[] — All possible locations of the job with coordinates, city, state, state_code, country_code, etc.
        - `id` integer, nullable — The unique identifier for the location, is based on the geonameid field from the geonames database
        - `name` string, nullable — The name of the location. If it's a city, it will be the city name; if it's a country, it will be the country name; if it's a region, it will be the region name, etc
        - `type` 'city' | 'region' | 'country' | 'continent'
        - `feature_code` string, nullable — GeoNames feature code (e.g., 'PPL' for populated place, 'ADM1' for first-order administrative division, 'PCLI' for country). Check all the possible feature codes in the GeoNames documentation
        - `country_code` string, nullable — ISO 3166-1 alpha-2 country code of the location
        - `admin1_name` string, nullable — The first level administrative division name of the location
        - `admin1_code` string, nullable — The first level administrative division code of the location
        - `admin2_name` string, nullable — The second level administrative division name of the location (e.g., county or district)
        - `admin2_code` string, nullable — The second level administrative division code of the location
        - `continent` string, nullable — Continent code of the location
        - `latitude` number, nullable — Geographic latitude coordinate for precise mapping
        - `longitude` number, nullable — Geographic longitude coordinate for precise mapping
        - `city` string, nullable — The city of the location (Deprecated): Use 'name' field when 'type' is 'city'
        - `address` unknown
        - `postal_code` unknown
        - `state` string, nullable — State of the location (Deprecated): Use 'admin1_name' instead
        - `state_code` string, nullable — State code of the location (Deprecated): Use 'admin1_code' instead
        - `display_name` string, required — A human-readable display name for the location, constructed from available location fields
        - `country_name` string, nullable, required — The full country name derived from the country_code
      - `normalized_title` string, nullable
      - `manager_roles` string[], nullable — Roles of the person or people found in the job description to be the managers of the hired person. Can be useful to infer who's the decision maker for the technologies mentioned in the job post.
      - `matching_phrases` string[], nullable — Phrases from the job description that match the pattern passed
      - `matching_words` string[], nullable — Words from the job description that match the pattern passed
    - CompanyWithTechnologiesAndJobsOutput
      - `id` string, required — Company ID
      - `name` string, required — Company name
      - `domain` string, nullable — Company domain
      - `industry` string, nullable — Industry of the company
      - `country` string, nullable — Country of the company's HQ
      - `country_code` string, nullable — ISO2 country code. E.g. "US"
      - `employee_count` integer, nullable — Number of employees of the company
      - `logo` string, nullable — Stable CDN-hosted company logo URL suitable for display in applications
      - `num_jobs` integer — Number of jobs from this company in our database
      - `num_technologies` integer — Number of technologies mentioned in the jobs of this company
      - `num_keywords` integer — Number of distinct keywords (technologies + buying intent topics) found in this company's jobs
      - `num_buying_intent_topics` integer — Number of distinct buying intent topic keywords found in this company's jobs
      - `possible_domains` string[] — List of possible domains for the company
      - `url` string, nullable — Company domain. Same as the "domain" field. Will be deprecated in the future.
      - `industry_id` integer, nullable — Code of the industry. One of LinkedIn's Industry Codes V2 from https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2
      - `linkedin_url` string, nullable
      - `num_jobs_last_30_days` integer — Number of jobs from this company in our database posted in the last 30 days
      - `num_jobs_found` integer, nullable — When filtering companies by jobs, number of jobs found for this company
      - `yc_batch` string, nullable — If the company went through YC, this is its batch
      - `apollo_id` string, nullable — ID of the company in Apollo
      - `linkedin_id` string, nullable — ID of the company in LinkedIn
      - `url_source` string, nullable — Source of the company URL
      - `is_recruiting_agency` boolean, nullable — Is a recruiting agency
      - `founded_year` integer, nullable — Year the company was founded
      - `annual_revenue_usd` number, nullable — Annual revenue of the company in USD
      - `annual_revenue_usd_readable` string, nullable — Annual revenue of the company in USD, formated as an easily readable string
      - `total_funding_usd` integer, nullable — Funding of the company in USD
      - `last_funding_round_date` string, date, nullable — Date of the last funding round of the company
      - `last_funding_round_amount_readable` string, nullable — Amount of the last funding round of the company, formated as an easily readable string
      - `employee_count_range` string, nullable — Number range of employees at the company
      - `long_description` string, nullable — Short description of the company
      - `seo_description` string, nullable — SEO description of the company, extracted from their website
      - `city` string, nullable — City of the company's HQ
      - `postal_code` string, nullable — Postal code of the company's HQ
      - `company_keywords` string[], nullable — Company keywords, related to what the company does. Deprecated: use company_tags instead.
      - `company_tags` string[] — Company keywords, related to what the company does
      - `alexa_ranking` integer, nullable — Alexa ranking
      - `publicly_traded_symbol` string, nullable
      - `publicly_traded_exchange` string, nullable
      - `investors` string[], nullable — List of investors in this company
      - `funding_stage` 'angel' | 'convertible_note' | 'debt_financing' | 'equity_crowdfunding' | 'other' | 'private_equity' | 'seed' | 'series_a' | 'series_b' | 'series_c' | 'series_d' | 'series_e' | 'series_f' | 'series_g' | 'series_h' | 'venture_round_not_specified' | 'series_i' | 'series_j' | 'undisclosed' | 'series_unknown' | 'pre_seed' | 'post_ipo_secondary' | 'post_ipo_equity' | 'post_ipo_debt' | 'non_equity_assistance' | 'late_vc' | 'initial_coin_offering' | 'growth_equity_vc' | 'grant' | 'early_vc' | 'corporate_round' | 'secondary_market' | 'product_crowdfunding'
      - `has_blurred_data` boolean — Whether the returned object has company identifiable data blurred or not
      - `keyword_slugs` string[] — Slugs of all keywords (technologies and buying intent topics) found in this company's jobs
      - `technology_slugs` string[], nullable — Slugs of the technologies found in this company's jobs. This is a subset of keyword_slugs filtered to only technology-type keywords.
      - `technology_names` string[], nullable — Names of the technologies found to be used by the company
      - `technologies_found` KeywordFoundV0Output[] — List of technologies found to be used by the company, relevant to the current search
        - `technology` KeywordExtended, required
          - `name` string, required
          - `category` string, nullable — Category of the keyword
          - `type` 'technology' | 'software_product' | 'technology_concept' | 'operational_activity' | 'strategic_initiative' | 'metric_or_concept' | 'product_or_service_offered' | 'regulation' | 'threat_or_risk' | 'event' | 'commodity' | 'industry_vertical' | 'physical_equipment' | 'medical_research' | 'government_body'
          - `slug` string, required — Slug of the keyword
          - `category_slug` string, nullable — Slug of the category of the keyword
          - `parent_category` string, nullable — Parent category of the keyword
          - `parent_category_slug` string, nullable — Slug of the parent category of the keyword
          - `logo` string, nullable — Logo of the keyword
          - `logo_thumbnail` string, nullable — Thumbnail of the keyword
        - `confidence` 'low' | 'medium' | 'high', required — How confident we are that the company uses this technology
        - `jobs` integer, required — Number of jobs found mentioning this technology
        - `jobs_last_7_days` integer, required — Number of jobs from the given company mentioning this technology in the last 7 days
        - `jobs_last_30_days` integer, required — Number of jobs from the given company mentioning this technology in the last 30 days
        - `jobs_last_180_days` integer, required — Number of jobs from the given company mentioning this technology in the last 180 days
        - `first_date_found` string, date, required — Date when the keyword was first mentioned by the company in a job post
        - `last_date_found` string, date, required — Date when the keyword was last mentioned by the company in a job post
        - `rank_within_category` integer, required — Measures how common this technology is among the company's jobs, compared to other technologies in the same category. The most mentioned technology in its category will have a rank of 1. This helps you infer which is the technology the company is most likely to be using, when they mention several technologies that belong to the same category.
        - `relative_occurrence_within_category` number, required — Measures the relative occurance of this technology among other technologies in the same category, in jobs by this company. If there are 10 jobs where a company mentions 3 categories, and they appear in 8, 3 and 2 jobs respectively, its relative occurrences will be 0.8, 0.3 and 0.2. This helps you infer how likely it is that the company is using this technology, when they mention several technologies that belong to the same category.
        - `theirstack_score` number, nullable — [DEPRECATED] This is a score we assign to every technology used by each company to assess how likely it is that they're using it, combining the value of `jobs` and `relative_occurrence_within_category`. The higher this value is, the higher the chances that the company uses this technology. Values lower than 1 mean it's not very likely they use it. Then, the higher the value of theirstack_score, the more likely it is that they actually use it.
        - `company_name` string, required — Company name. This field is deprecated, please don't use it
      - `jobs_found` JobBaseOut[] — List of the last 5 jobs posted by the company, relevant to the current search
        - `id` integer, nullable — ID of the job
        - `job_title` string, nullable — Job title
        - `url` string, nullable — URL of the job post
        - `source_url` string, nullable — Original source URL of the job post (e.g. job board URL)
        - `date_posted` string, date, nullable — Date when the job was posted
        - `has_blurred_data` boolean — Whether the returned object has company identifiable data blurred or not
        - `company` string, required
      - `keywords_found` KeywordFoundV0Output[] — List of buying intent keywords and technologies found in this company's jobs, relevant to the current search
        - `technology` KeywordExtended, required
          - `name` string, required
          - `category` string, nullable — Category of the keyword
          - `type` 'technology' | 'software_product' | 'technology_concept' | 'operational_activity' | 'strategic_initiative' | 'metric_or_concept' | 'product_or_service_offered' | 'regulation' | 'threat_or_risk' | 'event' | 'commodity' | 'industry_vertical' | 'physical_equipment' | 'medical_research' | 'government_body'
          - `slug` string, required — Slug of the keyword
          - `category_slug` string, nullable — Slug of the category of the keyword
          - `parent_category` string, nullable — Parent category of the keyword
          - `parent_category_slug` string, nullable — Slug of the parent category of the keyword
          - `logo` string, nullable — Logo of the keyword
          - `logo_thumbnail` string, nullable — Thumbnail of the keyword
        - `confidence` 'low' | 'medium' | 'high', required — How confident we are that the company uses this technology
        - `jobs` integer, required — Number of jobs found mentioning this technology
        - `jobs_last_7_days` integer, required — Number of jobs from the given company mentioning this technology in the last 7 days
        - `jobs_last_30_days` integer, required — Number of jobs from the given company mentioning this technology in the last 30 days
        - `jobs_last_180_days` integer, required — Number of jobs from the given company mentioning this technology in the last 180 days
        - `first_date_found` string, date, required — Date when the keyword was first mentioned by the company in a job post
        - `last_date_found` string, date, required — Date when the keyword was last mentioned by the company in a job post
        - `rank_within_category` integer, required — Measures how common this technology is among the company's jobs, compared to other technologies in the same category. The most mentioned technology in its category will have a rank of 1. This helps you infer which is the technology the company is most likely to be using, when they mention several technologies that belong to the same category.
        - `relative_occurrence_within_category` number, required — Measures the relative occurance of this technology among other technologies in the same category, in jobs by this company. If there are 10 jobs where a company mentions 3 categories, and they appear in 8, 3 and 2 jobs respectively, its relative occurrences will be 0.8, 0.3 and 0.2. This helps you infer how likely it is that the company is using this technology, when they mention several technologies that belong to the same category.
        - `theirstack_score` number, nullable — [DEPRECATED] This is a score we assign to every technology used by each company to assess how likely it is that they're using it, combining the value of `jobs` and `relative_occurrence_within_category`. The higher this value is, the higher the chances that the company uses this technology. Values lower than 1 mean it's not very likely they use it. Then, the higher the value of theirstack_score, the more likely it is that they actually use it.
        - `company_name` string, required — Company name. This field is deprecated, please don't use it
    - JobClosedPayload
      - `id` integer, required
      - `closed_at` string, date-time, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `response_status_code` integer, nullable
  - `response_body` string, nullable

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.net/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/versions/2723cd54b43e/schema)