# Work Shortlist API

> Work Shortlist API is a paid API for AI agents from x402-url-evidence.vercel.app, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-14).

Filters and shortlists work/task listings from task marketplaces, returning only those that meet quality and reward criteria

## Facts

- Endpoint: POST https://x402-url-evidence.vercel.app/api/work-shortlist
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/work-shortlist-api-6379bd72
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__RSvUOga7fNwuzCTL4c8o

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 work-shortlist-api-6379bd72 -d '<json body>'
```

Example prompt: Can you pull me a shortlist of up to 10 tasks from the task marketplace that pay at least $2 USDC — only include ones that are actually ready and assign work exclusively to the first applicant?

## When to prefer this

Use this endpoint when you need deterministic, rule-based filtering of task marketplace listings by reward threshold and quality signals (e.g. exclusivity of assignment). It is well-suited for agents that autonomously scout gig work or data tasks and need a clean shortlist without manual review. Prefer this over generic search when you specifically need to screen out non-exclusive or promotional tasks and want a structured accept/reject breakdown with reasoning.

## Known failure modes

- Invalid limit value outside 1-20 range returns validation error
- minRewardUsdc above 10000 or below 0 returns validation error
- No tasks available meeting criteria returns empty ready array with dataThin: true
- Incorrect bodyType or method enum value causes request rejection
- Payment not settled in USDC on Base causes 402 response

## How this service works

Paid deterministic utility APIs settled in native USDC on Base.

## Output

Returns a JSON object with 'ready' tasks (array of shortlisted tasks with title, source, reward in USDC, and reasons), 'rejected' tasks (array with title, source, and rejection reasons), 'readyCount' (number of ready tasks), 'reviewedCount' (total tasks reviewed), and a 'dataThin' boolean indicating if the dataset was sparse.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 20,
       "minimum": 1
      },
      "minRewardUsdc": {
       "type": "number",
       "maximum": 10000,
       "minimum": 0
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ready": [
   {
    "title": "Bounded data task",
    "source": "taskmarket",
    "reasons": [],
    "rewardUsdc": 5
   }
  ],
  "dataThin": false,
  "rejected": [
   {
    "title": "Promotion task",
    "source": "riner",
    "reasons": [
     "does not assign the first applicant exclusively"
    ]
   }
  ],
  "readyCount": 1,
  "reviewedCount": 12
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/work-shortlist-api-6379bd72/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-url-evidence.vercel.app](https://www.zero.xyz/host/x402-url-evidence.vercel.app/llms.txt)