Skip to content
luranta/docs

Search documentation

Search pages, sections and API operations.

List job facts
.md

API Reference/Facts

List job facts

GET
/v0/job-facts

Authorization

Authorization
Bearerrequired

Organisation API key supplied only through the Authorization header. Required scopes: jobs:read.

Query parameters

facts
objectoptional

Closed selections over explicitly disclosed job facts. Related action and target conditions match the same fact in one job.

applicantLocations
string[]optional

Canonical location IDs required in the job's applicant eligibility facts.

Maximum items:300
Maximum items 300
company
objectoptional

Company context. Values within each category use OR; categories combine with AND. Employee bounds must contain the whole disclosed interval. FTE never satisfies an employee-count filter.

salaryDisclosed
booleanoptional

Whether a qualifying base-pay amount is disclosed. False selects listings without such an amount; it does not assert that the employer pays no salary.

query
stringoptional

Full-text query matched against indexed job text and title similarity. Normalized to Unicode NFC with folded whitespace; 1–200 characters.

Range:1200
Examples ["software engineer"]Maximum length 200Minimum length 1
roles
enum[]optional

Role family or specialism codes from the Luranta catalogue. Jobs matching any supplied code are returned.

Maximum items:50
Available options:administration-office-supportadministrative-executive-assistanceoffice-front-deskclerical-data-entryrecords-document-controlagriculture-horticulture-forestry-fishing-animal-carefarming-agricultural-operationshorticulture-landscapingforestry-fishing-aquacultureveterinary-animal-carecreative-design-fashion-media-entertainmentvisual-ux-product-designfashion-textile-industrial-designfilm-television-audio-photographyanimation-vfx-gamingwriting-editing-publishingperforming-arts-live-productionbusiness-consulting-strategymanagement-consultingcorporate-commercial-strategybusiness-analysiscorporate-development-strategic-partnershipsconstruction-architecture-skilled-tradesarchitecture-urban-planningcivil-structural-constructionconstruction-management-site-supervisionbuilding-installation-tradessurveying-inspection-commissioningcustomer-service-supportcontact-centre-customer-servicecustomer-supporttechnical-product-supportcustomer-success-after-salesdata-analytics-aidata-analysis-business-intelligencedata-sciencedata-engineeringmachine-learning-aiquantitative-analytics-engineeringeducation-trainingearly-childhood-educationprimary-secondary-teachinghigher-education-academiaspecial-vocational-educationtraining-education-servicesenergy-utilities-mining-natural-resourcesmining-extractionoil-gaspower-generation-gridrenewable-energywater-waste-utilitiesgeology-resource-explorationengineering-technical-servicesmechanical-engineeringelectrical-electronics-engineeringchemical-process-engineeringaerospace-automotive-marine-engineeringhardware-semiconductor-robotics-engineeringsystems-test-reliability-technical-servicesfinance-accounting-insuranceaccounting-controllershipauditfinancial-planning-treasury-taxbanking-investments-tradingcredit-lendinginsurance-actuarialhealthcare-clinical-caremedicine-dentistrynursing-midwiferyallied-health-rehabilitationpharmacydiagnostics-imaging-clinical-laboratorymental-behavioural-healthclinical-support-healthcare-administrationhospitality-food-travel-tourismculinary-food-beveragehotels-rooms-guest-servicestravel-tourismevents-conferencesleisure-recreation-spahuman-resources-recruitmenttalent-acquisition-recruitmenthr-business-partnering-people-operationscompensation-benefitsemployee-relationsorganisational-workforce-developmentlegal-compliance-risklegal-services-operationsregulatory-affairs-complianceenterprise-operational-riskfinancial-crime-aml-fraudprivacy-governance-data-protectionmanufacturing-production-qualityproduction-plant-operationsmanufacturing-industrial-engineeringmachining-fabrication-assemblyquality-assurance-controlmaintenance-reliability-packagingmarketing-communications-prbrand-product-growth-marketingdigital-performance-marketingcommunications-public-relationscontent-social-mediamarket-research-marketing-eventsoperations-project-programme-managementbusiness-operationsproject-managementprogramme-portfolio-pmoprocess-improvement-service-operationspersonal-care-beauty-fitness-domestic-servicesbeauty-hair-cosmeticsfitness-sports-coachingchildcaredomestic-personal-carepolicy-public-administration-international-affairspublic-policy-administrationgovernment-affairs-diplomacyinternational-development-humanitarian-affairshuman-rights-economic-social-affairsproduct-managementproduct-management-generaltechnical-platform-product-managementproduct-operationsproduct-strategy-discoveryproperty-facilities-real-estateproperty-facilities-managementreal-estate-sales-leasingsurveying-valuationproperty-development-workplace-estatesprotective-emergency-security-defence-servicesphysical-corporate-securityinvestigation-loss-prevention-law-enforcementfire-rescue-emergency-medical-servicesemergency-management-occupational-safetymilitary-defenceresearch-science-sustainabilitylife-physical-sciencessocial-science-economicsclinical-preclinical-researchlaboratory-research-operationsenvironmental-science-climate-sustainabilityretail-buying-merchandisingstore-frontline-retailretail-managementbuying-category-managementmerchandising-planning-allocationsales-business-developmentfield-inside-salesaccount-managementbusiness-development-partnershipschannel-wholesale-salespresales-sales-operations-fundraisingsocial-community-religious-servicessocial-workcommunity-human-servicesyouth-family-social-carenonprofit-religious-servicessoftware-it-cybersecuritysoftware-engineeringweb-mobile-developmentcloud-platform-sre-devopsit-support-systems-administrationnetworks-infrastructurecybersecuritysoftware-quality-testingsupply-chain-procurement-logisticsprocurement-strategic-sourcingsupply-planning-inventorywarehousing-fulfilmentlogistics-freightsupply-chain-managementtransport-driving-aviationroad-transport-driving-deliverypilots-cabin-crewairport-ground-operationsrail-public-transitmaritime-shipboard-operations
Default []Examples [["software-engineering"]]Maximum items 50
locations
string[]optional

Place names resolved the same way as location search on luranta.com, for example London or United Kingdom. Jobs in any of the supplied places are returned.

Maximum items:300
Default []Examples [["London"]]Maximum items 300
companies
string[]optional

Company identifiers. Jobs at any of the supplied companies are returned.

Maximum items:20
Default []Examples [["019bf6e2-a668-7a1b-811d-c5845c739754"]]Maximum items 20
industries
enum[]optional

Industry sector codes assigned to the hiring company. Jobs matching any supplied sector are returned.

Maximum items:23
Available options:agriculture-forestry-fishingmining-natural-resourcesenergy-utilitiesenvironmental-waste-servicesmanufacturingfashion-textiles-apparelconsumer-goodsconstructionreal-estatewholesale-retailtransport-logistics-postalhospitality-food-travelmedia-arts-entertainmenttechnology-information-servicestelecommunicationsfinance-insuranceprofessional-business-serviceseducationhealthcare-life-sciencessocial-caregovernment-public-sectornonprofit-associationspersonal-household-services
Default []Examples [["technology-information-services"]]Maximum items 23
experience
objectoptional

Filter by stated years of experience.

tools
enum[]optional

Tool or technology codes identified for the job. Jobs matching any supplied code are returned.

Maximum items:50
Available options:ai-and-machine-learningbusiness-finance-and-erpcloud-infrastructure-and-securitycollaboration-and-productivitycreative-and-designdata-and-analyticsengineering-cad-and-geospatialhealthcare-and-laboratoryprogramming-languagessales-marketing-and-servicesoftware-delivery-and-testingsoftware-developmentdeveloper-tools-and-platformstypescriptjavascriptpythongorustcc-plus-plusc-sharpobjective-cjavakotlinswiftrubyphpscaladartelixirerlanghaskellluaperlrmatlabbashpowershellreactreact-nativenextjsnodejsangularvuejssvelteremixexpressnestjsdjangoflaskfastapiruby-on-railsspringlaraveldotnetasp-netflutterandroidiosreduxtailwind-csssqlpostgresqlmysqlmariadbsqliteoracle-databasemicrosoft-sql-servermongodbredisdynamodbcassandraelasticsearchopensearchbigqueryredshiftdbtairflowsparkflinkhadooptrinoclickhouseneo4jsupabasedatabrickssnowflakekafkapytorchtensorflownumpypandasscikit-learnjaxkerasxgboosthugging-facelangchainllamaindexmlflowcudaopenai-apianthropic-apiragcomputer-visionnlpllmsai-agentslinuxgitgithub-actionsgitlab-cijenkinscircleciargo-cdkuberneteshelmdockeransibleterraformpulumiopenshiftawsgcpazurecloudflarevercelnetlifyserverlessprometheusgrafanaopentelemetrydatadogsplunkgraphqlrestgrpcrabbitmqnatswebsocketsvitewebpackjestvitestcypressplaywrightseleniumstorybookexcelmicrosoft-powerpointmicrosoft-wordmicrosoft-outlookmicrosoft-teamsmicrosoft-sharepointgoogle-workspaceslacknotionjiraconfluenceadobe-photoshopadobe-illustratoradobe-indesignadobe-premiere-proadobe-after-effectsadobe-acrobatcanvafigmablenderautodesk-mayafinal-cut-proautocadautodesk-revitsolidworkscatiasiemens-nxautodesk-fusion-360sketchuparcgisqgisautodesk-civil-3dansyslabviewprocoreprimavera-p6tableaupower-bilookeralteryxsasibm-spssstataminitabsaporacle-erpnetsuitemicrosoft-dynamics-365workdayquickbooksxerosageservicenowbloomberg-terminalsalesforcehubspotmarketogoogle-adsmeta-adsgoogle-analyticszendeskepicoracle-healthmeditechveeva-vaultlimsziggleamjuliaclojuref-sharpocamlgroovyfortrancobolsolidityvhdlverilogassemblyabapapexcrystalnimvisual-basichtml5csssasslesspostcsshtmxjquerywebassemblydenobunastronuxtgatsbysolidjsqwikember-jsalpine-jslitelectrontauriioniccapacitorbootstrapmuiant-designchakra-uishadcn-uiradix-uibase-uithree-jsd3-jstanstackzustandzodrxjsprismadrizzle-ormsqlalchemyhibernateentity-frameworkmongoosesequelizeknex-jsphoenixsymfonycakephpcodeigniterfastifykoahonoadonisjsactixqtunityunreal-enginegodotexpojetpack-composeswiftuiopencvopenglvulkanwebrtcgithubgitlabbitbucketazure-devopsapache-mavengradlenpmpnpmyarnpippoetrycomposernugetcmakebazelnxturborepobabelrollupesbuildswcpostmaninsomniaswaggerpytestmochachaijasminecucumberk6apache-jmeterpactsonarqubesentryvisual-studio-codevisual-studiointellij-ideapycharmwebstormandroid-studioxcodeeclipsevimneovimmamptravis-citeamcitybuildkiteflux-cdtektonskaffoldgnu-makenixgithub-copilotcodexclaude-codeclaudeopencodeopenrouterollamamistral-aiqwengoogle-geminideepseekcursorwindsurfv0coheregroqvercel-ai-sdkcloudflare-workersfastlyalibaba-cloudapache-cloudstackapache-tomcatwp-enginedebianubuntured-hat-enterprise-linuxcentosrocky-linuxalpine-linuxfedoraarch-linuxwindows-serveroracle-cloudibm-clouddigitaloceanherokufly-iorenderrailwayfirebaseakamaiopenstackcloud-foundryvmwareproxmoxnomadconsulhashicorp-vaultpackeristioenvoynginxapache-http-servercaddytraefikhaproxyoktaauth0keycloaksnyktrivyowaspburp-suitewiresharkmetasploitpalo-alto-networksfortinetzscalercrowdstrikeciscojuniper-networksf5tailscalewireguardkibanalogstashgrafana-lokinew-relicdynatracepagerdutyopsgeniehoneycombplanetscalepolarsduckdbcockroachdbinfluxdbtimescaledbcouchdbcouchbasesinglestoretidbpineconeqdrantweaviatemilvustursoapache-hiveprestoapache-druidapache-beamapache-supersetmetabaseqlikjupyterrstudioplotlyscipymatplotlibapache-icebergfivetranairbytedagsterprefectapache-pulsaractivemqmqttlinearclickupworkplaceasanatrellomonday-comairtablemirozoomdropboxboxmicrosoft-onedrivebasecamptodoistloomsmartsheetshortcutmattermostwebexzapiern8nmake-comuipathmicrosoft-power-automatemicrosoft-power-appsmicrosoft-projectgoogle-search-consolegoogle-tag-managersemrushahrefsmailchimpklaviyobrazesegmentmixpanelamplitudehotjaroptimizelycontentfulsanitywordpresswebflowshopifywoocommercemagentobigcommerceintercomfreshdeskhootsuitepipedriveadobe-analyticsdrupaljoomlaghostsquarespacewixprestashopodoosap-successfactorsadp-workforce-nowukgdayforcebamboohrdocusignstripepaypalsquareanaplanworkivasketchframeradobe-xdadobe-lightroomadobe-auditiondavinci-resolveavid-media-composerpro-toolsaudacityableton-livefl-studiocinema-4daffinity-designeraffinity-photoinkscapegimpkritacoreldrawhoudinizbrushmapboxopenstreetmapgoogle-earthcartorhino-3darchicadautodesk-inventoraltium-designerkicadsimulinkrosbenchlinglabware
Default []Examples [["typescript"]]Maximum items 50
workArrangements
enum[]optional

Work arrangements. Jobs matching any supplied value are returned.

Maximum items:3
Available options:on_sitehybridremote
Default []Examples [["hybrid","remote"]]Maximum items 3
schedules
enum[]optional

Employment schedules. Jobs matching any supplied value are returned.

Maximum items:2
Available options:full-timepart-time
Default []Examples [["full-time"]]Maximum items 2
engagements
enum[]optional

Engagement types. Jobs matching any supplied value are returned.

Maximum items:7
Available options:permanentfixed-termcontract-freelancetemporary-seasonal-casualinternshipapprenticeshipvolunteer
Default []Examples [["permanent"]]Maximum items 7
visaSponsorship
booleanoptional

When true, return only jobs explicitly marked as offering visa sponsorship. Defaults to false.

Default falseExamples [true]
languages
enum[]optional

Catalogue language codes. A job must use a supplied listing language and satisfy each language-requirement group with a supplied language.

Maximum items:50
Available options:enesfrdeitptnlplsvnodafiarhehibnzhjakoidmsthvitrruukcsazjbebhobsbgcebckbfuvhahmshnjhrhuigilojvkkrwkoilnmadmagmaimrnpinypbupespltqugrornskrsosrsuswhtluruznyozuzybtetaguknmlmypaamsiel
Default []Examples [["en"]]Maximum items 50
compensation
objectoptional

Filter and sort by disclosed compensation. Bounds are annual USD comparison amounts; resource packages still use the listed currency.

freshness
enumoptional
Available options:any7-days30-days90-days365-days
sort
enumoptional
Available options:recencycompensation
paginationToken
stringoptional

Opaque keyset token from meta.nextToken or meta.previousToken. Reuse it with unchanged filters and sort. Expires after 24 hours.

Range:11000
Maximum length 1000Minimum length 1

Responses

A page of source-attributed observation bundles.

Pagination

meta
objectrequired

data
object[]required
Maximum items:50
Maximum items 50

Headers

Luranta-Cost-USD
stringoptional

Credit consumed as a USD decimal string. Present only on successful billable responses.

Pattern:^(?:0|[1-9]\d*)\.\d{2,6}$
Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
Luranta-Credit-Balance-USD
stringoptional

Organisation credit remaining after settlement. Present only on successful billable responses.

Pattern:^(?:0|[1-9]\d*)\.\d{2,6}$
Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
Luranta-Resources-Returned
integeroptional

Number of resources returned and charged. Present only on successful billable responses.

Range:02147483647
Maximum 2147483647Minimum 0
traceparent
stringrequired

W3C trace context generated for this request attempt.

Pattern:^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
X-Request-Id
stringrequired

Unique UUIDv7 identifier for this request attempt.

Format:uuid
Format uuid