# 2s.io Federal Job Search

> 2s.io Federal Job Search is a paid API for AI agents from 2s.io, paid per call via x402, $0.0012/call, status unknown (last checked 2026-09-14).

Search current US federal government job postings via USAJobs API with filters for keyword, location, pay grade, agency, and work schedule

## Facts

- Endpoint: GET https://2s.io/api/job/federal-search
- Price: $0.0012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-6f3b3ad5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vni14Zd2gRsEyZXHz5xbb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-io-6f3b3ad5
```

Example prompt: Find me open federal IT jobs (occupational series 2210) in Washington, DC at the GS-09 to GS-13 pay grade that are open to the public, sorted by close date descending — show me the first 10 results.

## When to prefer this

Use this endpoint when you need to search live, current US federal government job postings from USAJobs. Prefer this over general job search APIs when the user specifically wants federal/government positions, needs GS pay grade filtering, needs to filter by agency or occupational series codes, or needs telework/remote eligibility filtering specific to federal employment classifications.

## Known failure modes

- Invalid pay grade format (e.g. malformed GS code) returns empty results or error
- Unknown organization/agency sub-element code returns no results
- Invalid jobCategoryCode returns empty results
- Page out of range returns empty results array
- USAJobs API upstream downtime causes 500 or timeout
- Payment of 0.0012 USDC not fulfilled triggers 402 error

## How this service works

Search current US federal job postings via the USAJobs API. Filter by keyword, positionTitle, locationName ("Washington, DC" or city/zip), remote (telework-eligible), pay grade range (e.g. payGradeLow=GS09 + payGradeHigh=GS13), jobCategoryCode (occupational series, e.g. 2210 for IT), organization (agency sub-element code, e.g. TR40 for IRS), whoMayApply (all/public/status). Returns per-posting: control number, position ID, title, USAJobs URL + apply URL, organization + department, locations, schedule, offering type, pay scales (min/max + interval), publication start + application close, qualification summary, job category + grade. Use sortField + sortDirection to sort. Pagination via resultsPerPage + page.

## Output

A paginated list of federal job postings, each including the control number, position ID, job title, direct USAJobs URL and application URL, hiring organization and department name, work locations, schedule type, offering type, pay scale minimum and maximum with pay interval, publication start and application close dates, a qualification summary, and job category with grade information.

## Request schema (JSON Schema)

```json
{
 "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": {
     "properties": {
      "page": {
       "type": "integer",
       "default": 1,
       "minimum": 1
      },
      "remote": {
       "type": "boolean"
      },
      "keyword": {
       "type": "string"
      },
      "sortField": {
       "enum": [
        "OpenDate",
        "CloseDate",
        "PositionTitle",
        "Salary"
       ],
       "type": "string"
      },
      "payGradeLow": {
       "type": "string",
       "description": "e.g. GS09"
      },
      "whoMayApply": {
       "enum": [
        "all",
        "public",
        "status"
       ],
       "type": "string"
      },
      "locationName": {
       "type": "string"
      },
      "organization": {
       "type": "string",
       "description": "Agency sub-element code."
      },
      "payGradeHigh": {
       "type": "string"
      },
      "positionTitle": {
       "type": "string"
      },
      "sortDirection": {
       "enum": [
        "Asc",
        "Desc"
       ],
       "type": "string"
      },
      "resultsPerPage": {
       "type": "integer",
       "default": 25,
       "maximum": 500,
       "minimum": 1
      },
      "jobCategoryCode": {
       "type": "string",
       "description": "Occupational series, e.g. 2210."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-6f3b3ad5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)