# Agentic Reservations — List Reservation Jobs

> Agentic Reservations — List Reservation Jobs is a free API for AI agents from agentres.dev, callable via x402, Free, status unknown (last checked 2026-09-14).

Lists and filters reservation booking jobs submitted to the AgentRes/Resy system, returning their current status, restaurant details, and payment state.

## Facts

- Endpoint: GET https://agentres.dev/api/reservation-jobs
- Price: Free
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentic-reservations-list-reservation-jobs-584bf050
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sgAFxeN_AIq_qxgo16mfj

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 agentic-reservations-list-reservation-jobs-584bf050
```

Example prompt: Show me all my reservation jobs on AgentRes — especially any that are still queued or running — and let me know which ones succeeded and what the payment status is for each.

## When to prefer this

Use this endpoint when you need to poll or audit the state of previously submitted restaurant reservation jobs on AgentRes/Resy — for example, to check if a booking succeeded, confirm payment was processed, or identify jobs that need attention (failed, timed out, or pending refund). Prefer this over creating a new booking job when the goal is status monitoring or reporting rather than initiating a new reservation.

## Known failure modes

- Invalid status enum value returns a validation error
- Limit parameter out of range (below 1 or above 100) returns a validation error
- Unauthenticated requests may return 401 or 402 requiring payment/auth
- Empty result set returns jobs array with count 0 when no jobs match the filter
- Network timeouts or upstream unavailability return 5xx errors

## How this service works

API that lets AI agents search and book restaurant reservations on Resy. Pay $0.01 USDC per booking with a crypto wallet.

## Output

A JSON object containing a list of reservation job records and a total count. Each job record includes a UUID job ID, current status (queued, running, succeeded, failed, canceled, etc.), the target restaurant name, reservation date, party size, drop time, and detailed payment state (rail, payment status, amount in cents, and any pending refund claim instructions).

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 100,
       "minimum": 1
      },
      "status": {
       "enum": [
        "queued",
        "running",
        "cancel_requested",
        "succeeded",
        "failed",
        "canceled",
        "timed_out"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "jobs": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "job_id": {
          "type": "string",
          "format": "uuid"
         },
         "status": {
          "enum": [
           "queued",
           "running",
           "cancel_requested",
           "succeeded",
           "failed",
           "canceled",
           "timed_out"
          ],
          "type": "string"
         },
         "payment": {
          "type": "object",
          "properties": {
           "rail": {
            "type": "string"
           },
           "status": {
            "enum": [
             "paid",
             "covered",
             "refund_pending",
             "refunded",
             "refund_failed"
            ],
            "type": "string"
           },
           "next_step": {
            "type": "string",
            "description": "Present when refund_pending — the refund claim call to make"
           },
           "amount_cents": {
            "type": "integer"
           }
          },
          "description": "Billing state of the charge that funded this job"
         },
         "venue_id": {
          "type": "string",
          "nullable": true
         },
         "charge_id": {
          "type": "string",
          "format": "uuid"
         },
         "drop_time": {
          "type": "string",
          "format": "date-time"
         },
         "party_size": {
          "typ
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "jobs": [
   {
    "job_id": "0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
    "status": "queued",
    "drop_time": "2026-07-15T13:00:00Z",
    "restaurant_name": "4 Charles Prime Rib",
    "reservation_date": "2026-08-14"
   }
  ],
  "count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentic-reservations-list-reservation-jobs-584bf050/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentres.dev](https://www.zero.xyz/host/agentres.dev/llms.txt)