---
title: "Poll until the owner starts the day pass"
method: POST
path: "/api/day-pass/status"
tags: ["Day pass"]
---

# Poll until the owner starts the day pass

`POST /api/day-pass/status`

## Request

- Base URL: `https://listingsapi.com`
- URL: `https://listingsapi.com/api/day-pass/status`
- Auth: none required
- TypeScript: <https://skmtc.dev/listingsapi/apis/listings-api/docs/api/day-pass/status/post.ts> (a function with typed inputs; its response is checked against the schema)

Answers `{"status": "pending"}` with a Retry-After header until the owner presses Start my day pass in the email, then returns the same credentials as the start call.

## Request body

- object
  - `poll_token` string, required

## Response `200`

Still pending, or the credentials.

- union
  - object
    - `status` 'pending'
    - `retry_after_seconds` integer
  - object
    - `status` 'active', required
    - `api_key` string, required: Send as `Authorization: API <api_key>`.
    - `authorization_header` string
    - `api_base_url` string, uri, required
    - `mcp_url` string, uri, required
    - `expires_at` string, date-time, nullable
    - `limits` object
      - `locations` integer, nullable
      - `requests_per_minute` integer, nullable
      - `requests_per_day` integer, nullable
    - `includes` string[]
    - `demo_directories` object[]
      - `name` string
      - `sync` 'instant' | 'delayed'
    - `dashboard_url` string, uri
    - `docs` string, uri
    - `next_steps` string[]

## Other responses

- `400`: Missing or malformed poll_token.
- `410`: `poll_token_expired` or `sandbox_expired`.
- `429`: `rate_limit_exceeded`.
- `503`: `pass_not_started`: retry the same call.

## Changes

- **2026-09-28** `b0ba79d54dad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/listingsapi/apis/listings-api/changes/api/day-pass/status/post.md)

---

[API](https://skmtc.dev/listingsapi/apis/listings-api.md) - [All operations](https://skmtc.dev/listingsapi/apis/listings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/listingsapi/apis/listings-api/revisions/2658a20b9b66?raw)