{"uid":"cap_erP5zfVc5b4CL50NmCD5y","slug":"laborwage-occupations-fe3e1861","name":"laborwage-occupations","description":"Resolve an occupation title to ranked SOC candidates, each with the SOC code, official title and a match score. The cheap first step before a prevailing-wage determination when only a job title is known.","url":"https://payai.agentstools.dev/wage/occupations","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["occupation"],"properties":{"limit":{"type":"integer","maximum":25,"minimum":1,"description":"Maximum candidates (default 10)"},"occupation":{"type":"string","description":"Occupation title to resolve"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zQDMytro9lRq3mv9vEZoa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a free-text occupation title to a ranked list of Standard Occupational Classification (SOC) candidates with codes, official titles, and match scores.","exampleAgentPrompt":"What are the top SOC code matches for 'Machine Learning Engineer'? Give me up to 5 ranked candidates with their official titles and match scores.","exampleUseCases":[{"title":"H-1B prevailing wage research","prompt":"Before I do a prevailing wage lookup, can you find the best matching SOC codes for 'Full Stack Developer'? Show me the top 5 candidates so I can pick the right one."},{"title":"HR job posting compliance","prompt":"We're posting a job for a 'Logistics Coordinator' and need the official SOC classification. Can you give me the ranked SOC code matches for that title?"},{"title":"Workforce analytics occupational mapping","prompt":"I have a list of internal job titles and need to map them to standard occupational codes. Start with 'Data Governance Analyst' — what are the top SOC candidates and their scores?"}],"resultDescription":"Returns a ranked list of SOC (Standard Occupational Classification) candidates matching the input occupation title. Each candidate includes the SOC code (e.g. 15-1252), the official BLS/DOL occupation title, and a numeric match score indicating relevance. Results are ordered from best to worst match, limited by the requested number of candidates (default 10, max 25).","failureModes":["Missing required 'occupation' query parameter returns a validation error","Very obscure or highly specialized job titles may return low match scores or few candidates","Ambiguous titles (e.g. 'Manager') may return many candidates with similar scores making selection difficult","Limit parameter outside 1-25 range returns an error","Network or service downtime returns a non-200 status"],"whenToPreferThis":"Use this endpoint as the first step in any prevailing-wage determination workflow when you only have a free-text job title and need the correct SOC code. It is cheaper and faster than full wage lookups, making it ideal for narrowing down classification before committing to a more expensive wage query. Prefer this over manual SOC code lookup tables when the job title is non-standard or ambiguous.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:01:19.071Z","isFirstParty":false}