---
title: "Get saved search"
method: POST
path: "/v1/saved-search/get"
tags: ["Saved search"]
---

# Get saved search

`POST /v1/saved-search/get`

Get all details for a specific saved search

<span>⚡ <strong>Rate limit:</strong> 120 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> FREE! No credits are charged for this API.&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Request body

- object
  - `apiKey` string, required — Your Fiber API key
  - `savedSearchId` string, required — The ID of the saved search

## Response `200`

Default Response

- object
  - `output` object, required
    - `id` string, required — The ID of the saved search
    - `name` string, required — The name of the saved search
    - `type` 'combined' | 'company_only' | 'prospect_only', required — The type of the saved search
    - `spawnFrequencyDays` integer, required — The frequency of the saved search in days.
    - `estimatedDateOfNextSpawn` string, nullable — The estimated date of the next spawn of the saved search
    - `lastSpawnedAt` string, nullable — The date and time the last spawn of the saved search
    - `pastSpawnsDates` string[], nullable — The dates of the past spawns (max 100) of the saved search
    - `isActive` boolean, required — Whether the saved search is active i.e whether to auto spawn it or not.
    - `companySearchParams` object, nullable — Search parameters for company search API.
      - `exactCompanyV2` object, nullable
        - `anyOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `noneOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
      - `domains` string[], nullable
      - `headquartersCountryCode` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
      - `headquartersStateName` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
      - `employeeCountV2` object, nullable
        - `lowerBoundExclusive` integer, nullable
        - `upperBoundInclusive` integer, nullable
      - `keywords` object, nullable
        - `containsAll` string[], nullable
        - `containsAny` string[], nullable
        - `containsNone` string[], nullable
      - `industriesV2` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
        - `allOf` string[], nullable
      - `stage` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
      - `totalFundingUSD` object, nullable
        - `lowerBound` number, nullable
        - `upperBound` number, nullable
      - `lastFundingUSD` object, nullable
        - `lowerBound` number, nullable
        - `upperBound` number, nullable
      - `lastFundedOn` union
        - object
          - `strategy` 'absolute', required
          - `range` object, nullable
            - `lowerBound` string, nullable
            - `upperBound` string, nullable
        - object
          - `strategy` 'relative', required
          - `window` union
            - object
              - …
            - object
              - …
            - object
              - …
      - `foundedOn` union
        - object
          - `strategy` 'absolute', required
          - `range` object, nullable
            - `lowerBound` string, nullable
            - `upperBound` string, nullable
        - object
          - `strategy` 'relative', required
          - `window` union
            - object
              - …
            - object
              - …
            - object
              - …
      - `nameLike` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
      - `exactCompany` object, nullable
        - `anyOf` object[], nullable
          - `linkedin_id` string, nullable
          - `li_org_id` string, required
          - `preferred_name` string, nullable
          - `names` string[], nullable
          - `linkedin_primary_slug` string, nullable
          - `domains` string[], nullable
          - `logo_url` string, nullable
          - `source` 'csv' | 'null', nullable
        - `noneOf` object[], nullable
          - `linkedin_id` string, nullable
          - `li_org_id` string, required
          - `preferred_name` string, nullable
          - `names` string[], nullable
          - `linkedin_primary_slug` string, nullable
          - `domains` string[], nullable
          - `logo_url` string, nullable
          - `source` 'csv' | 'null', nullable
      - `acceleratorsV2` object, nullable
        - `anyOf` object[], nullable
          - `acceleratorName` 'a16z_speedrun' | 'accel_atoms' | 'ai2_incubator' | 'alchemist_accelerator' | 'alliance' | 'antler' | 'berkeley_skydeck' | 'founders_inc' | 'google_startups' | 'launch_accelerator' | 'neo' | 'pear_x' | 'plug_and_play' | 'sosv' | 'south_park_commons' | 'startx' | 'techstars' | 'the_mint' | 'ycombinator', required
          - `batchSelection` union
            - object
              - …
            - object
              - …
          - `years` object, nullable
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
        - `noneOf` object[], nullable
          - `acceleratorName` 'a16z_speedrun' | 'accel_atoms' | 'ai2_incubator' | 'alchemist_accelerator' | 'alliance' | 'antler' | 'berkeley_skydeck' | 'founders_inc' | 'google_startups' | 'launch_accelerator' | 'neo' | 'pear_x' | 'plug_and_play' | 'sosv' | 'south_park_commons' | 'startx' | 'techstars' | 'the_mint' | 'ycombinator', required
          - `batchSelection` union
            - object
              - …
            - object
              - …
          - `years` object, nullable
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
      - `headquartersLocation` object, nullable
        - `unionAll` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `subtractAll` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
      - `linkedinSlugs` string[], nullable
      - `specialFlags` object, nullable
        - `excludeYcCompanies` boolean, nullable
      - `employees` object, nullable
        - `rules` object[], required
          - `employeesToMatch` union, required
            - object
              - …
            - object
              - …
          - `employeeFilters` object, nullable
            - `countryCode` string[], nullable
            - `jobTitle` string[], nullable
            - `recentlyHired` object[], nullable
              - …
          - `jobStatus` union
            - object
              - …
            - object
              - …
            - object
              - …
        - `joiner` 'AND' | 'OR', required
      - `naicsCodes` object, nullable
        - `anyOf` object[], nullable
          - `code` string, required
          - `title` string, required
        - `allOf` object[], nullable
          - `code` string, required
          - `title` string, required
        - `noneOf` object[], nullable
          - `code` string, required
          - `title` string, required
      - `fortuneRankings` object, nullable
        - `anyOf` object[], nullable
          - `list` 'fortune-500-usa', required
          - `range` object, required
            - `low` number, required
            - `high` number, required
            - `name` string, nullable
          - `year` number, required
      - `jobPostingsV2` object, nullable
        - `anyOf` object[], nullable
          - `jobPostingStatus` 'active' | 'closed' | 'either' | 'null', nullable
          - `jobTitle` string[], nullable
          - `keywords` string[], nullable
          - `postedAt` union
            - object
              - …
            - object
              - …
          - `numApplicants` object, nullable
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
          - `annualPayUSD` object, nullable
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
          - `yearsOfExperience` object, nullable
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
          - `geoLocation` union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `countryOrRegionCode` string[], nullable
          - `seniority` string[], nullable
          - `employmentType` string[], nullable
          - `jobFunction` string[], nullable
          - `industry` string[], nullable
          - `jobLocationType` string[], nullable
        - `allOf` object[], nullable
          - `jobPostingStatus` 'active' | 'closed' | 'either' | 'null', nullable
          - `jobTitle` string[], nullable
          - `keywords` string[], nullable
          - `postedAt` union
            - object
              - …
            - object
              - …
          - `numApplicants` object, nullable
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
          - `annualPayUSD` object, nullable
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
          - `yearsOfExperience` object, nullable
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
          - `geoLocation` union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `countryOrRegionCode` string[], nullable
          - `seniority` string[], nullable
          - `employmentType` string[], nullable
          - `jobFunction` string[], nullable
          - `industry` string[], nullable
          - `jobLocationType` string[], nullable
        - `noneOf` object[], nullable
          - `jobPostingStatus` 'active' | 'closed' | 'either' | 'null', nullable
          - `jobTitle` string[], nullable
          - `keywords` string[], nullable
          - `postedAt` union
            - object
              - …
            - object
              - …
          - `numApplicants` object, nullable
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
          - `annualPayUSD` object, nullable
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
          - `yearsOfExperience` object, nullable
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
          - `geoLocation` union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `countryOrRegionCode` string[], nullable
          - `seniority` string[], nullable
          - `employmentType` string[], nullable
          - `jobFunction` string[], nullable
          - `industry` string[], nullable
          - `jobLocationType` string[], nullable
      - `jobPostingStats` object, nullable
        - `anyOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `allOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `noneOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
      - `officeLocationsV2` object, nullable
        - `anyOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `allOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `noneOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
      - `tlds` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
      - `numWordsInName` object, nullable
        - `lowerBound` integer, nullable
        - `upperBound` integer, nullable
      - `status` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
      - `technologies` object, nullable
        - `anyOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
        - `allOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
        - `noneOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
      - `crunchbaseCategories` object, nullable
        - `anyOf` object[], nullable
          - `group` string, required
          - `category` string, required
          - `type` 'category', required
        - `allOf` object[], nullable
          - `group` string, required
          - `category` string, required
          - `type` 'category', required
        - `noneOf` object[], nullable
          - `group` string, required
          - `category` string, required
          - `type` 'category', required
      - `crunchbaseCategoryGroups` object, nullable
        - `anyOf` object[], nullable
          - `group` string, required
          - `type` 'group', required
        - `allOf` object[], nullable
          - `group` string, required
          - `type` 'group', required
        - `noneOf` object[], nullable
          - `group` string, required
          - `type` 'group', required
      - `crunchbaseSlugs` string[], nullable
      - `investorsV2` object, nullable
        - `anyOf` object[], nullable
          - `investorIdentifier` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `investedAt` union
            - object
              - …
            - object
              - …
          - `investmentRounds` object, nullable
            - `anyOf` string[], required
        - `allOf` object[], nullable
          - `investorIdentifier` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `investedAt` union
            - object
              - …
            - object
              - …
          - `investmentRounds` object, nullable
            - `anyOf` string[], required
        - `noneOf` object[], nullable
          - `investorIdentifier` union, required
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `investedAt` union
            - object
              - …
            - object
              - …
          - `investmentRounds` object, nullable
            - `anyOf` string[], required
      - `technologiesV2` object, nullable
        - `anyOf` string[], nullable
        - `allOf` string[], nullable
        - `noneOf` string[], nullable
      - `revenueRangeUSD` object, nullable
        - `lowerBound` integer, nullable
        - `upperBound` integer, nullable
      - `employeeTrendsV2` object, nullable
        - `obeysAll` union[], nullable
          - union
            - object
              - …
            - object
              - …
        - `obeysAny` union[], nullable
          - union
            - object
              - …
            - object
              - …
        - `obeysNone` union[], nullable
          - union
            - object
              - …
            - object
              - …
      - `tags` object, nullable
        - `anyOf` string[], nullable
        - `allOf` string[], nullable
        - `noneOf` string[], nullable
      - `linkedinIndustries` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
      - `sort` object[], nullable — Sort order for company results. Clauses are applied in order. Omit to use the default ranking. Note: changing the sort invalidates any existing cursor — start a new pagination run when the sort changes.
        - `field` 'totalFunding' | 'lastRoundFunding' | 'lastFundedAt' | 'foundedAt' | 'followerCount' | 'jobPostingCount' | 'employeeCount' | 'revenueEstimate', required
        - `direction` 'asc' | 'desc', required
    - `maxNewCompaniesPerRun` integer, nullable — Maximum number of new companies to charge for per run.
    - `profileSearchParams` object, nullable — Search parameters for people search.
      - `country3LetterCode` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
      - `numConnections` object, nullable
        - `lowerBound` number, nullable
        - `upperBound` number, nullable
      - `numFollowers` object, nullable
        - `lowerBound` number, nullable
        - `upperBound` number, nullable
      - `approxAge` object, nullable
        - `lowerBound` number, nullable
        - `upperBound` number, nullable
      - `keywords` object, nullable
        - `containsAll` string[], nullable
        - `containsAny` string[], nullable
        - `containsNone` string[], nullable
      - `keywordsV2` object, nullable
        - `operator` 'AND' | 'OR', required
        - `clauses` object[], required
          - `operator` 'AND' | 'OR', required
          - `terms` string[], required
          - `negate` boolean, required
        - `options` object, nullable
          - `fieldsToSearchOver` object, nullable
            - `summary` boolean, required
            - `headline` boolean, required
            - `pastJobTitles` boolean, required
            - `pastJobSummaries` boolean, required
            - `pastCompanyNames` boolean, required
            - `currentJobTitles` boolean, required
            - `currentJobSummaries` boolean, required
            - `currentCompanyNames` boolean, required
            - `interests` boolean, required
            - `skills` boolean, required
            - `industry` boolean, required
            - `education` boolean, required
            - `publications` boolean, required
            - `certifications` boolean, required
            - `articles` boolean, required
            - `courses` boolean, required
            - `projects` boolean, required
            - `patents` boolean, required
            - `volunteering` boolean, required
            - `languages` boolean, required
      - `keywordSearchOptions` object, nullable
        - `fieldsToSearchOver` object, nullable
          - `summary` boolean, required
          - `headline` boolean, required
          - `pastJobTitles` boolean, required
          - `pastJobSummaries` boolean, required
          - `pastCompanyNames` boolean, required
          - `currentJobTitles` boolean, required
          - `currentJobSummaries` boolean, required
          - `currentCompanyNames` boolean, required
          - `interests` boolean, required
          - `skills` boolean, required
          - `industry` boolean, required
          - `education` boolean, required
          - `publications` boolean, required
          - `certifications` boolean, required
          - `articles` boolean, required
          - `courses` boolean, required
          - `projects` boolean, required
          - `patents` boolean, required
          - `volunteering` boolean, required
          - `languages` boolean, required
      - `jobTitleV2` object, nullable
        - `anyOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `noneOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `allOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
      - `exactProfile` object, nullable
        - `anyOf` object[], nullable
          - `profile_id` string, nullable
          - `primary_slug` string, nullable
        - `noneOf` object[], nullable
          - `profile_id` string, nullable
          - `primary_slug` string, nullable
      - `exactProfileV2` object, nullable
        - `anyOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `noneOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
      - `startedInRole` union
        - object
          - `strategy` 'absolute', required
          - `range` object, nullable
            - `lowerBound` string, nullable
            - `upperBound` string, nullable
        - object
          - `strategy` 'relative', required
          - `window` union
            - object
              - …
            - object
              - …
            - object
              - …
      - `startedAtCompany` union
        - object
          - `strategy` 'absolute', required
          - `range` object, nullable
            - `lowerBound` string, nullable
            - `upperBound` string, nullable
        - object
          - `strategy` 'relative', required
          - `window` union
            - object
              - …
            - object
              - …
            - object
              - …
      - `location` object, nullable
        - `unionAll` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `subtractAll` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
      - `languages` object, nullable
        - `anyOf` string[], nullable
        - `allOf` string[], nullable
        - `noneOf` string[], nullable
      - `leftStealthAt` union
        - object
          - `strategy` 'absolute', required
          - `range` object, nullable
            - `lowerBound` string, nullable
            - `upperBound` string, nullable
        - object
          - `strategy` 'relative', required
          - `window` union
            - object
              - …
            - object
              - …
            - object
              - …
      - `isInStealth` boolean, nullable
      - `stealthV2` union
        - object
          - `status` 'currently-in-stealth', required
          - `enteredStealthAt` union
            - object
              - …
            - object
              - …
        - object
          - `status` 'left-stealth', required
          - `leftStealthAt` union
            - object
              - …
            - object
              - …
          - `enteredStealthAt` union
            - object
              - …
            - object
              - …
          - `stealthDuration` object, nullable
            - `range` object, required
              - …
            - `period` 'day' | 'week' | 'month' | 'quarter' | 'year', required
      - `educationV2` object, nullable
        - `anyOf` object[], nullable
          - `keywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `degree` union
            - object
              - …
            - object
              - …
          - `fieldOfStudy` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `school` object, nullable
            - `exact` object, nullable
              - …
            - `nameKeywords` object, nullable
              - …
            - `properties` object, nullable
              - …
          - `years` object, nullable
            - `startedSchoolAt` union
              - …
            - `finishedSchoolAt` union
              - …
            - `isCurrentlyStudent` boolean, nullable
        - `allOf` object[], nullable
          - `keywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `degree` union
            - object
              - …
            - object
              - …
          - `fieldOfStudy` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `school` object, nullable
            - `exact` object, nullable
              - …
            - `nameKeywords` object, nullable
              - …
            - `properties` object, nullable
              - …
          - `years` object, nullable
            - `startedSchoolAt` union
              - …
            - `finishedSchoolAt` union
              - …
            - `isCurrentlyStudent` boolean, nullable
      - `jobStatus` union
        - object
          - `status` 'currently-employed', required
        - object
          - `status` 'previously-employed', required
          - `leftAt` union
            - object
              - …
            - object
              - …
        - object
          - `status` 'ever-employed', required
      - `timeZone` object, nullable
        - `anyOf` object[], required
          - `strategy` object, required
            - `mode` 'midpoint-with-buffer', required
            - `midpointTimeZoneName` string, required
            - `maxMinutesWestward` integer, required
            - `maxMinutesEastward` number, required
            - `includePartialYearMatches` boolean, required
      - `pastJobText` object, nullable
        - `joiner` 'and' | 'or', required
        - `criteria` object[], required
          - `field` 'title' | 'summary' | 'anywhere', required
          - `rule` 'includes' | 'excludes', required
          - `text` string, nullable
      - `fuzzyName` object, nullable
        - `anyOf` object[], required
          - `name` string, required
      - `companyMatchMode` union
        - object
          - `mode` 'strict', required
        - object
          - `mode` 'loose', required
      - `yearsOfExperience` object, nullable
        - `lowerBound` number, nullable
        - `upperBound` number, nullable
      - `jobTitleV3` object, nullable
        - `anyOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `allOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `noneOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
      - `openToWork` boolean, nullable
      - `isHiring` boolean, nullable
      - `hasProfilePicture` boolean, nullable
      - `state` object, nullable
        - `anyOf` object[], nullable
          - `countryCode` string, nullable
          - `stateName` string, required
        - `noneOf` object[], nullable
          - `countryCode` string, nullable
          - `stateName` string, required
      - `certifications` object, nullable
        - `anyOf` object[], nullable
          - `keywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
        - `allOf` object[], nullable
          - `keywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
      - `publications` object, nullable
        - `anyOf` object[], nullable
          - `keywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
        - `allOf` object[], nullable
          - `keywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
      - `hasNoEducation` boolean, nullable
      - `employmentType` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
      - `isTopVoice` boolean, nullable
      - `hasPremium` boolean, nullable
      - `isInfluencer` boolean, nullable
      - `industry` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
      - `isVerified` boolean, nullable
      - `joinedLinkedInAt` union
        - object
          - `strategy` 'absolute', required
          - `range` object, nullable
            - `lowerBound` string, nullable
            - `upperBound` string, nullable
        - object
          - `strategy` 'relative', required
          - `window` union
            - object
              - …
            - object
              - …
            - object
              - …
      - `unemployment` object, nullable
        - `isUnemployed` boolean, required
        - `becameUnemployedAt` union
          - object
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
      - `getDetailedEducation` boolean, nullable, required — Whether to include deep details about each educational item, like the school's LinkedIn URL, website, location, etc. That'll be put in the detailedEducation array. This slows down the API call, so only enable this if you need it.
      - `getDetailedWorkExperience` boolean, nullable, required — Whether to include deep details about each work experience item, like the company's LinkedIn URL, website, location, etc. That'll be put in the detailedWorkExperience array. This slows down the API call, so only enable this if you need it.
      - `tags` object, nullable
        - `anyOf` string[], nullable
        - `allOf` string[], nullable
        - `noneOf` string[], nullable
      - `education` object, nullable
        - `anyOf` object[], nullable
          - `school` object, nullable
            - `anyOf` object[], nullable
              - …
            - `noneOf` object[], nullable
              - …
          - `schoolV2` object, nullable
            - `anyOf` object[], nullable
              - …
            - `noneOf` object[], nullable
              - …
          - `keywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `degree` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `degreeV2` union
            - object
              - …
            - object
              - …
          - `schoolNameKeywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `finishedSchoolAt` union
            - object
              - …
            - object
              - …
          - `startedSchoolAt` union
            - object
              - …
            - object
              - …
          - `isCurrentlyStudent` boolean, nullable
        - `allOf` object[], nullable
          - `school` object, nullable
            - `anyOf` object[], nullable
              - …
            - `noneOf` object[], nullable
              - …
          - `schoolV2` object, nullable
            - `anyOf` object[], nullable
              - …
            - `noneOf` object[], nullable
              - …
          - `keywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `degree` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `degreeV2` union
            - object
              - …
            - object
              - …
          - `schoolNameKeywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `finishedSchoolAt` union
            - object
              - …
            - object
              - …
          - `startedSchoolAt` union
            - object
              - …
            - object
              - …
          - `isCurrentlyStudent` boolean, nullable
      - `jobs` object, nullable — Filter by work experience: named companies (LinkedIn org ID, URL, slug, or domain), job titles, or both on the same entry, with per-entry tenure. Replaces the deprecated pastJobs and currentJobs fields. Prefer jobs alone during migration — sending jobs together with pastJobs or currentJobs ANDs them as separate query clauses.
        - `anyOf` object[], nullable — Match a person who satisfies any of these entries.
          - `company` union — Company to match. Identify by LinkedIn org ID, LinkedIn URL, LinkedIn slug, or website domain.
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `jobTitle` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `status` 'current' | 'past' | 'any', required
        - `allOf` object[], nullable — Require every entry to be satisfied by the same person. Each entry can be at a different company and tenure.
          - `company` union — Company to match. Identify by LinkedIn org ID, LinkedIn URL, LinkedIn slug, or website domain.
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `jobTitle` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `status` 'current' | 'past' | 'any', required
        - `noneOf` object[], nullable — Exclude any person who satisfies these entries. Naming the same company in both anyOf and noneOf excludes anyone who held the excluded-tenure role there.
          - `company` union — Company to match. Identify by LinkedIn org ID, LinkedIn URL, LinkedIn slug, or website domain.
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `jobTitle` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `status` 'current' | 'past' | 'any', required
      - `pastJobs` object, nullable — Deprecated. Use jobs with status: 'past' instead.
        - `anyOf` object[], nullable
          - `jobTitle` string[], nullable
          - `company` object, nullable
            - `linkedin_id` string, nullable
            - `li_org_id` string, required
            - `preferred_name` string, nullable
            - `names` string[], nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `logo_url` string, nullable
            - `source` 'csv' | 'null', nullable
        - `allOf` object[], nullable
          - `jobTitle` string[], nullable
          - `company` object, nullable
            - `linkedin_id` string, nullable
            - `li_org_id` string, required
            - `preferred_name` string, nullable
            - `names` string[], nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `logo_url` string, nullable
            - `source` 'csv' | 'null', nullable
        - `noneOf` object[], nullable
          - `jobTitle` string[], nullable
          - `company` object, nullable
            - `linkedin_id` string, nullable
            - `li_org_id` string, required
            - `preferred_name` string, nullable
            - `names` string[], nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `logo_url` string, nullable
            - `source` 'csv' | 'null', nullable
      - `currentJobs` object, nullable — Deprecated. Use jobs with status: 'current' instead.
        - `anyOf` object[], nullable
          - `jobTitle` string[], nullable
          - `company` object, nullable
            - `linkedin_id` string, nullable
            - `li_org_id` string, required
            - `preferred_name` string, nullable
            - `names` string[], nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `logo_url` string, nullable
            - `source` 'csv' | 'null', nullable
        - `allOf` object[], nullable
          - `jobTitle` string[], nullable
          - `company` object, nullable
            - `linkedin_id` string, nullable
            - `li_org_id` string, required
            - `preferred_name` string, nullable
            - `names` string[], nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `logo_url` string, nullable
            - `source` 'csv' | 'null', nullable
        - `noneOf` object[], nullable
          - `jobTitle` string[], nullable
          - `company` object, nullable
            - `linkedin_id` string, nullable
            - `li_org_id` string, required
            - `preferred_name` string, nullable
            - `names` string[], nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `logo_url` string, nullable
            - `source` 'csv' | 'null', nullable
      - `sort` object[], nullable — Sort order for people results. Clauses are applied in order. Omit to use the default ranking. Note: changing the sort invalidates any existing cursor — start a new pagination run when the sort changes.
        - `field` 'followerCount' | 'connectionCount' | 'careerStartedAt' | 'dataUpdatedAt' | 'currentRoleStartedAt' | 'currentCompanyStartedAt' | 'jobCount', required
        - `direction` 'asc' | 'desc', required
    - `maxNewProfilesPerRun` integer, nullable — Maximum number of new profiles to charge for per run.
    - `skipUntil` string, nullable — If set, the next auto-run is suppressed until this date. Null means no skip is active and auto-runs proceed on schedule.
  - `chargeInfo` union, required
    - object — Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
  - `warnings` object[], nullable — Warnings about extraneous fields in request
    - `field` string, required — Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required — Warning message
  - `advice` string[], nullable — Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `402` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `429` — Default Response
- `500` — Default Response
- `503` — Default Response

---

[API](https://skmtc.net/fiber/apis/fiber-ai-api.md) · [All operations](https://skmtc.net/fiber/apis/fiber-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/revisions/720c63a313eb/schema)
