{"uid":"cap_jSt_F9v_LmIHPT7twrLnN","slug":"agents-predictleads-com-get-a-single-job-opening-by-id-8df756fc","name":"Get a single Job Opening by ID","description":"Returns a single Job Opening.","url":"https://agents.predictleads.com/api/v3/job_openings/{id}?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","format":"uuid","description":"JobOpening's ID.\n"}}},"responseSchema":{"type":"object","title":"JobOpeningsDataset","$schema":"https://json-schema.org/draft/2020-12/schema","example":{"data":[{"id":"4d5ac23c-5824-427d-96c6-4e8d50a4241a","type":"job_opening","attributes":{"url":"https://www.ycombinator.com/companies/terra-api/jobs/0f5CP0r-ai-engineer","tags":["Python","Ruby","JavaScript"],"title":"AI Engineer","salary":"$50000","status":"closed","language":"en","location":"London, United Kingdom, Northern Europe, Europe","onet_data":{"code":"15-1299.08","family":"Computer and Mathematical","occupation_name":"Computer Systems Engineers/Architects"},"posted_at":null,"seniority":"mid_senior","categories":["software_development","data_analysis"],"description":"# AI Engineer\n\n$50K - $120K•0.10% - 0.50%•London, England, GB\n\n**Job type**\n\nFull-time\n\n**Role**\n\nEngineering, Machine learning\n\n**Experience**\n\nAny (new grads ok)\n\n**Visa**\n\nUS citizenship/visa not required\n\nApply to Terra API and hundreds of other fast-growing YC startups with a single profile.\n\nApply to role ›\n\n## About the role\n\nWe work in super small teams, with extremely high velocity.\n\nWe are building multiple AI products, such as OdinAI, Graph API, and many more\n\nAs an AI engineer, you'll work in a small team, with maximum autonomy.\n\n* Be behind the curtain, creating, testing, and implementing AI models\n* Engage in data analysis, machine learning, and natural language processing.\n* Fine-tuning the AI's performance\n  and many more\n\nPreferred background:\n\nBachelor's or Master's degree in STEM.\nStrong technical skills (e.g. familiarity with a programming language such as Python, JavaScript, or Ruby)\nExperience with growth marketing, product development, and user acquisition/retention\n\n**Must haves.**\n\n-Must have done this before, or be willing to learn fast.\n\n-Must be fast. We operate at 200mph, and so do you.\n\n-Must be relentless. We never stop, so you are even faster than us.\n\n-Must have customer driven. We think customers first and so should you.\n\n-Must be driven and go above and beyond.\n\n-Must be able to explain and communicate clearly.\n\n-Must be prepared to challenge us and disagree. We are thinking and acting as a team.\n\n-Must be able to work autonomously.\n\n-Must want to work hard.\n\n-Last but not least, you are genuinely a nice person.\n\n**Big plus** You are an athlete, or care about quantifying your data\n\n## About Terra API\n\n## What we do\n\nTerra is the infrastructure layer for health data access.\n\nHealth data is trapped across hundreds of siloed sources: wearables, sensors, health apps, medical devices, blood tests, team systems, and clinical platforms. Every source has its own authentication, permissions, schema, latency, edge cases, and reliability problems.\n\nTerra abstracts all of that into one platform.\n\nWe give companies a single way to connect to health data, normalize it, stream it, analyze it, and build products on top of it. Today, Terra powers some of the top health companies in the world, as well as leading AI labs building the next generation of health intelligence.\n\nWe deliver more than 30 billion activities per year through infrastructure built for scale, security, and reliability.\n\n## Vision\n\nThe future of health is extreme personalization.\n\nHealth will move from care plans to goal setting: living to 120, winning the Olympics, becoming sharper, reversing disease, or performing at the top of any field.\n\nAI will help people understand themselves, predict outcomes 10 years ahead, and choose what they want to become.\n\nTo do that, AI needs continuous, permissioned, real-world health data from every source.\n\nTerra is building the infrastructure that makes this possible.\n\nTerra API\n\nFounded:2021\n\nBatch:W21\n\nTeam Size:25\n\nStatus:Active\n\nLocation:London, United Kingdom","salary_data":{"salary_low":50000,"salary_high":120000,"salary_low_usd":50000,"salary_currency":"USD","salary_high_usd":120000,"salary_time_unit":"year"},"last_seen_at":"2026-10-29T08:28:38Z","first_seen_at":"2025-10-17T19:11:22Z","location_data":[{"city":"London","state":null,"region":"Northern Europe","country":"United Kingdom","zip_code":null,"continent":"Europe","fuzzy_match":false}],"contract_types":["full time"],"recruiter_data":{"name":null,"title":null,"contact":null},"normalized_title":"AI Engineer","translated_title":null,"last_processed_at":"2026-10-27T13:27:18Z"},"relationships":{"company":{"data":{"id":"eb383981-96cf-5d24-8e09-15f71f35879e","type":"company"}}}}],"meta":{"record_state":"active","schema_version":"3.3"},"included":[{"id":"eb383981-96cf-5d24-8e09-15f71f35879e","type":"company","attributes":{"domain":"tryterra.co","ticker":null,"company_name":"Terra Enabling Developers, Ltd."}}]},"summary":"Information about Job Openings sourced directly from company websites for highest accuracy and freshness.\n","required":["data","included"],"properties":{"data":{"type":"array","items":{"type":"object","title":"JobOpening","required":["id","type","attributes","relationships"],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the `JobOpening` object."},"type":{"const":"job_opening","description":"Type of the `JobOpening` object."},"attributes":{"type":"object","required":["title","translated_title","normalized_title","description","url","first_seen_at","last_seen_at","last_processed_at","contract_types","categories","onet_data","posted_at","recruiter_data","salary","salary_data","seniority","status","language","location","location_data","tags"],"properties":{"url":{"type":"string","description":"URL of the web page where the data was found."},"tags":{"type":"array","items":{"type":"string"},"description":"Includes keywords found under `JobOpening` description."},"title":{"type":"string","description":"Job title."},"salary":{"type":["string","null"],"example":"£40000 - £50000 GBP","description":"Raw salary string."},"status":{"enum":["closed",null],"description":"null or \"closed\" if keyword \"job no longer available\", \"vacancy listing expired\", \"position filled\", etc. is found on `JobOpening` site."},"language":{"type":["string","null"],"description":"Language in which a `JobOpening` description is written."},"location":{"type":["string","null"],"example":"Menlo Park, California, 94025, United States, Northern America, Americas","description":"`JobOpening` location.\n<br>\n**NOTE**: It is built from the `location_data` attributes if present. Otherwise, it falls back to the original unnormalized detected location string.\n"},"onet_data":{"type":"object","required":["code","family","occupation_name"],"properties":{"code":{"type":["string","null"],"example":"29-1021.00","description":"O\\*NET category code representing this `JobOpening`.\nSee list of <a target=\"_blank\" rel=\"noopener\" href=\"https://www.onetonline.org/find/all\">O\\*NET codes</a>.\n"},"family":{"type":["string","null"],"example":"Healthcare Practitioners and Technical","description":"O\\*NET family name matching the code for this `JobOpening`."},"occupation_name":{"type":["string","null"],"example":"Dentists, General","description":"O\\*NET occupation name matching the code for this `JobOpening`."}},"description":"Inferred O\\*NET data for this `JobOpening`. O\\*NET is a source and standardization of occupational information. More info on the O\\*NET data: onetonline.org."},"posted_at":{"type":["string","null"],"format":"date-time","example":"2024-09-25T16:09:53Z","description":"Date & time (ISO 8601) of when the `JobOpening` was posted."},"seniority":{"enum":["not_set","founder","c_level","partner","president","vice_president","head","director","manager","mid_senior","junior"],"type":["string","null"],"description":"Seniority inferred from the `JobOpening` title."},"categories":{"type":"array","items":{"enum":["administration","consulting","data_analysis","design","directors","education","engineering","finance","healthcare_services","human_resources","information_technology","internship","legal","management","marketing","military_and_protective_services","operations","purchasing","product_management","quality_assurance","real_estate","research","sales","software_development","support","manual_work","food"]},"example":["finance","data_analysis"],"description":"Zero or more organizational categories of the `JobOpening`."},"description":{"type":["string","null"],"description":"`JobOpening` description."},"salary_data":{"type":"object","required":["salary_low","salary_high","salary_currency","salary_low_usd","salary_high_usd","salary_time_unit"],"properties":{"salary_low":{"type":["number","null"],"description":"Salary range lower bound. If salary is not a range both low and high values will be the same."},"salary_high":{"type":["number","null"],"description":"Salary range upper bound."},"salary_low_usd":{"type":["number","null"],"description":"Salary range lower bound, converted to USD."},"salary_currency":{"type":["string","null"],"description":"Salary currency."},"salary_high_usd":{"type":["number","null"],"description":"Salary range upper bound, converted to USD."},"salary_time_unit":{"enum":["hour","day","week","month","year",null],"description":"Salary time unit."}},"description":"Parsed raw salary data."},"last_seen_at":{"type":"string","format":"date-time","example":"2024-09-25T16:09:53Z","description":"Date & time (ISO 8601) of when the `JobOpening` was last seen."},"first_seen_at":{"type":"string","format":"date-time","example":"2024-09-25T16:09:53Z","description":"Date & time (ISO 8601) of when the `JobOpening` was first seen."},"location_data":{"type":"array","items":{"type":"object","title":"LocationData","example":{"city":"Menlo Park","state":"California","region":"Northern America","country":"United States","zip_code":"94025","continent":"Americas","fuzzy_match":null},"required":["city","state","zip_code","country","region","continent","fuzzy_match"],"properties":{"city":{"type":["string","null"],"example":"Menlo Park","description":"City of the location."},"state":{"type":["string","null"],"example":"California","description":"State of the location."},"region":{"type":["string","null"],"example":"Northern America","description":"Region of the location."},"country":{"type":["string","null"],"example":"United States","description":"Country of the location."},"zip_code":{"type":["string","null"],"example":"94025","description":"ZIP code of the location."},"continent":{"type":["string","null"],"example":"Americas","description":"Continent of the location."},"fuzzy_match":{"type":["boolean","null"],"example":null,"description":"`true` indicates that location data may not have been extracted accurately.\n<br>\n`false` indicates that location data has been extracted correctly.\n"}},"description":"The `LocationData` object.\n<br>\n**NOTE**: It is used to build the `location` attribute.\n"},"description":"**NOTE**: Currently contains at most one object."},"contract_types":{"type":"array","items":{"type":"string"},"example":["full time","remote"],"description":"Zero or more types describing the `JobOpening`."},"recruiter_data":{"type":"object","required":["name","title","contact"],"properties":{"name":{"type":["string","null"],"example":"John Doe","description":"Name of the contact responsible for hiring for this `JobOpening`."},"title":{"type":["string","null"],"example":"Talent Acquisition Supervisor","description":"Title of the contact responsible for hiring for this `JobOpening`."},"contact":{"type":["string","null"],"example":"http://ca.linkedin.com/in/linkedinyourname","description":"Contact info for this `JobOpening`, such as email address or Linkedin profile URL."}},"description":"Info about the contact responsible for hiring for this `JobOpening`."},"normalized_title":{"type":["string","null"],"description":"Normalized job title with various noise (location, noise, team, gender, contract type etc.) information stripped."},"translated_title":{"type":["string","null"],"description":"Job title translated to English when a non-English language is detected."},"last_processed_at":{"type":"string","format":"date-time","example":"2024-09-25T16:09:53Z","description":"Date & time (ISO 8601) of when the `JobOpening` was last sent to processing."}},"description":"Attributes of the `JobOpening` object."},"relationships":{"type":"object","required":["company"],"properties":{"company":{"type":"object","title":"JobOpeningToCompanyLiteRelationship","required":["data"],"properties":{"data":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the included `CompanyLite` object."},"type":{"const":"company","description":"Type of the included `CompanyLite` object."}}}},"description":"The data contains a reference to related `CompanyLite` object listed in the `included` property."}},"description":"The data contains references to related objects listed in the `included` property."}},"description":"The `JobOpening` object."}},"meta":{"type":"object","required":["schema_version","record_state"],"properties":{"count":{"type":"integer","example":344,"description":"Total number of results.\n<br>\n**NOTE**: Only included in API responses when the request parameter `page` is provided,\nfor performance reasons.\n"},"record_state":{"type":"string","const":"active","title":"Meta.RecordState","description":"Represents record state of objects.\n"},"schema_version":{"type":"string","title":"Meta.SchemaVersion","description":"Represents schema version of objects.\n"},"crawler_potentially_blocked":{"type":"boolean","example":false,"description":"Whether our crawlers returned errors indicating the website might be blocking us.\n<br>\n**NOTE**: Only shown in API responses.\n"},"no_active_openings_confirmed":{"type":["boolean","null"],"example":true,"description":"Whether the absence of active job openings has been confirmed by the company's jobs subpage.\n<br>\n`null` unless an `active_only=true` request returns no openings (i.e. not an `active_only` request,\nthe website has not been processed yet, or active openings were returned). When set, `true` means the\njobs subpage confirmed the absence and `false` means it did not.\n<br>\n**NOTE**: Only shown in API responses.\n"}},"description":"Meta information about `JobOpeningsDataset` object.\n"},"included":{"type":"array","items":{"type":"object","title":"CompanyLite","required":["id","type","attributes"],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the `CompanyLite` object."},"type":{"const":"company","description":"Type of the `CompanyLite` object."},"attributes":{"type":"object","required":["domain","company_name","ticker"],"properties":{"domain":{"type":"string","description":"Company domain name."},"ticker":{"type":["string","null"],"description":"Company stock symbol (ticker) if available."},"company_name":{"type":["string","null"],"description":"Company name if available."}},"description":"Attributes of the `CompanyLite` object."}},"description":"The `CompanyLite` object."},"description":"Contains objects referenced in property `relationships`."}},"description":"PredictLeads has historical jobs data since 2016 that includes over 300 million records, and is available\nfor 3 million companies, which includes an average of 9.8 million active jobs at any given time.\n<br><br>\nJob Openings are sourced directly from company websites which includes their career subpages, and ATS\nintegrations. All Jobs are categorized using industry-standard\n<a target=\"_blank\" rel=\"noopener\" href=\"https://www.onetonline.org/\">O\\*NET codes</a>.\n<br><br>\nThe Job Openings Dataset includes fields such as Job Opening Title, Job Opening URL, First Seen At,\nLast Seen At, Location, Category, Seniority, Description, Salary, Contract Type, O\\*NET Job Category Codes\nand other Job Opening information.\n"},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.04","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Vkhg7LF0vyVNVX3a67ZnJ","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.predictleads.com","brandSlug":"agents-predictleads-com-x402","brandBaseUrl":"https://agents.predictleads.com","brandDocsUrl":null,"whatItDoes":"Retrieves detailed information about a specific job opening record from PredictLeads by its unique UUID.","exampleAgentPrompt":"Can you pull up the full details for the PredictLeads job opening with ID 4d5ac23c-5824-427d-96c6-4e8d50a4241a? I need the title, salary, location, seniority, and the job description.","exampleUseCases":[{"title":"Enrich job lead with full posting details","prompt":"I have a job opening ID from a PredictLeads search — 4d5ac23c-5824-427d-96c6-4e8d50a4241a — can you fetch the full record so I can see the title, salary range, location, and what skills they're asking for?"},{"title":"Verify job seniority before outreach","prompt":"Before I reach out to this company, can you check the PredictLeads job opening with ID 7b3fc12a-1234-567d-89ab-0f1e2c3d4e5f and tell me whether it's a senior or mid-level role and what categories it falls under?"},{"title":"Classify job for labor market research","prompt":"I'm analyzing hiring trends — please get the full PredictLeads job opening record for UUID a1b2c3d4-e5f6-7890-abcd-ef1234567890, including its onet occupation code, family, and any tags attached to it."}],"resultDescription":"Returns a JSON object with a single job opening record including its UUID, type, and attributes such as the job title, URL, salary, location, seniority level (e.g. mid_senior), posting status, language, categories (e.g. software_development), tags (e.g. Python, Ruby), onet classification data (code, family, occupation name), posted_at timestamp, and full job description text.","failureModes":["Invalid or malformed UUID returns a 400 or 422 validation error","Non-existent job opening ID returns a 404 not found response","Expired or unpaid account credentials return a 401 or 402 payment required error","Rate limiting may result in a 429 too many requests response","The job opening may exist but have null fields for salary, status, or posted_at if that data was not captured"],"whenToPreferThis":"Use this endpoint when you already have a specific job opening UUID from a prior search or discovery call and need the full record details. It is the most direct and cost-effective way to retrieve complete attributes (title, salary, location, seniority, onet data, description) for a single known job. Prefer this over broader search endpoints when you don't need to scan or filter — just hydrate a known ID.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:06:12.146Z","isFirstParty":false,"canonicalSlug":"agents-predictleads-com-get-a-single-job-opening-by-id-8df756fc"}