{"uid":"cap_u57Hcbs2OowxCX5cF5TkI","slug":"2s-io-7b8ec433","name":"USAJobs Federal Reference Codelist Lookup","description":"Fetch a USAJobs reference codelist (lookup tables behind every federal job posting). Pass name to pick which list: agencysubelements (every agency + sub-element), occupationalseries (2210 IT, 0301 Misc Admin, 0801 Engineer, etc.), paygrades, payplans (GS, SES, ES, WG, etc.), hiringpaths (veteran, military spouse, native American, etc.), securityclearances, locationcodes, countries, countrysubdivisions, ethnicities, racecodes, militarystatuscodes, languagecodes, positionscheduletypecodes (full-time/part-time/seasonal), travelpercentages, missioncriticalcodes, cyberworkroles, etc. (33 lists total). Use the returned codes as filter inputs to /api/job/federal-search.","url":"https://2s.io/api/job/federal-codes","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["name"],"properties":{"name":{"enum":["academichonors","agencysubelements","announcementclosingtypes","applicantsuppliers","cyberworkroles","countries","countrysubdivisions","degreetypecodes","documentations","ethnicities","federalemploymentstatuses","geoloccodes","hiringpaths","languagecodes","languageproficiencies","locationcodes","militarystatuscodes","missioncriticalcodes","occupationalseries","paygrades","payplans","positionofferingtypecodes","positionopeningstatuses","positionscheduletypecodes","racecodes","refereetypecodes","remunerationrateintervalcodes","requiredstandarddocuments","securityclearances","servicetypes","specialhirings","travelpercentages","whomayapply"],"type":"string"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"name":"securityclearances"}}},"response":{"data":{"ok":true,"meta":{"name":"securityclearances","dateGenerated":"2026-06-12T04:15:05.5654765Z"},"items":[{"Code":"0","Value":"Not Required","IsDisabled":"No","LastModified":"2019-01-11T12:05:10.347"},{"Code":"1","Value":"Confidential","IsDisabled":"No","LastModified":"2013-10-27T00:38:38.987"},{"Code":"2","Value":"Secret","IsDisabled":"No","LastModified":"2013-10-27T00:38:38.99"},{"Code":"3","Value":"Top Secret","IsDisabled":"No","LastModified":"2013-10-27T00:38:38.99"},{"Code":"4","Value":"Sensitive Compartmented Information","IsDisabled":"No","LastModified":"2019-01-11T12:05:10.347"},{"Code":"5","Value":"Q Access Authorization","IsDisabled":"No","LastModified":"2019-01-11T12:05:10.363"},{"Code":"6","Value":"Q - Nonsensitive","IsDisabled":"Yes","LastModified":"2019-01-11T12:05:10.363"},{"Code":"7","Value":"L Access Authorization","IsDisabled":"No","LastModified":"2019-01-11T12:05:10.363"},{"Code":"8","Value":"Other","IsDisabled":"No","LastModified":"2013-10-27T00:38:38.99"},{"Code":"9","Value":"Public Trust - Background Investigation","IsDisabled":"Yes","LastModified":"2019-01-11T12:05:10.363"}],"total":10,"source":{"url":"https://developer.usajobs.gov/","license":"Public domain (US government work)","provider":"USAJobs API (US Office of Personnel Management)"}},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"job.federal-codes","settlement":{"txHash":"0x6c1829807e6569de4dd9c184b6ed8f5d0d30c429a64fb1888fe2ea57d12d0a83","network":"eip155:8453","success":true}}}},"exampleRequest":{"name":"securityclearances"},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_N8aInqztxt6iiwiWjYTy3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches one of 33 official USAJobs reference codelists (agencies, pay plans, hiring paths, occupational series, security clearances, etc.) used as filter inputs for federal job searches.","exampleAgentPrompt":"Can you pull the full list of federal hiring path codes from USAJobs — I need the valid values like 'veterans', 'military spouse', and 'native American' so I can use them to filter a federal job search?","exampleUseCases":null,"resultDescription":"Returns a reference codelist array containing code-value pairs (e.g. code ID + human-readable label) for the requested list type — such as all agency subelements, all GS/SES/WG pay plans, all occupational series with titles, all hiring path identifiers, etc. These codes are used as structured filter parameters for the USAJobs federal job search endpoint.","failureModes":["Invalid or missing 'name' parameter returns an error — must be one of the 33 exact enum values","Network timeout if USAJobs upstream is unavailable","Empty list returned if the codelist has no current entries","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to discover or validate the exact code values accepted by the federal job search endpoint (/api/job/federal-search). This is the authoritative source for all USAJobs reference data — agencies, pay plans, occupational series, hiring paths, clearances, etc. Prefer this over hardcoding values, as the lists are maintained by OPM and may change.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:54:23.136Z","isFirstParty":false}