# Agentic Reservations — List Restaurant Reservations (Resy)

> Agentic Reservations — List Restaurant Reservations (Resy) is a free API for AI agents from agentic-reservations.vercel.app, callable via x402, Free, status unknown (last checked 2026-09-14).

Retrieves a paginated list of upcoming or past restaurant reservations for an AI agent via the Resy platform

## Facts

- Endpoint: GET https://agentic-reservations.vercel.app/api/reservations
- 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-restaurant-reservations-resy-f24adae9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EQM0qT0YjkMHEjecXGLqM

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-restaurant-reservations-resy-f24adae9
```

Example prompt: Can you pull up my upcoming Resy restaurant reservations — show me the next 10 bookings I have scheduled?

## When to prefer this

Use this endpoint when an AI agent needs to retrieve a user's existing Resy restaurant reservations — either upcoming or historical. It is the correct choice when the agent needs reservation details (time, venue, seats) or the resy_token needed to cancel a booking. Prefer this over booking endpoints when the goal is to read or audit reservations rather than create new ones.

## Known failure modes

- Invalid type enum value (not 'upcoming' or 'past') returns a validation error
- Limit exceeding 50 returns a validation error
- Offset out of range returns an empty reservations array
- Missing or invalid authentication credentials returns 401 Unauthorized
- Resy API unavailability causes upstream 503 errors
- Payment/wallet issues may prevent access if the x402 payment layer is invoked

## How this service works

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

## Output

Returns a paginated object containing the reservation type (upcoming or past), total count, limit, offset, and an array of reservation objects. Each reservation includes the date, time slot, number of seats, config type, a resy_token (usable to cancel via POST /api/cancel), and venue details including name, rating, cuisine type, address, and neighborhood.

## 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": {
      "type": {
       "enum": [
        "upcoming",
        "past"
       ],
       "type": "string",
       "default": "upcoming",
       "description": "Which reservations to list"
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 50,
       "minimum": 1
      },
      "offset": {
       "type": "integer",
       "default": 0,
       "minimum": 0
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "type": {
       "enum": [
        "upcoming",
        "past"
       ],
       "type": "string"
      },
      "limit": {
       "type": "integer"
      },
      "total": {
       "type": "integer"
      },
      "offset": {
       "type": "integer"
      },
      "reservations": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "day": {
          "type": "string",
          "format": "date"
         },
         "venue": {
          "type": "object",
          "properties": {
           "id": {
            "type": "integer"
           },
           "name": {
            "type": "string"
           },
           "rating": {
            "type": "number",
            "nullable": true
           },
           "cuisine": {
            "type": "string",
            "nullable": true
           },
           "address_1": {
            "type": "string",
            "nullable": true
           },
           "neighborhood": {
            "type": "string",
            "nullable": true
           }
          }
         },
         "num_seats": {
          "type": "integer"
         },
         "time_slot": {
          "type": "string"
         },
         "resy_token": {
          "type": "string",
          "description": "Pass to POST /api/cancel to cancel this reservation"
         },
         "config_type": {
          "type": "string"
   
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentic-reservations-list-restaurant-reservations-resy-f24adae9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentic-reservations.vercel.app](https://www.zero.xyz/host/agentic-reservations.vercel.app/llms.txt)