Walkthroughs

Get Walkthroughs

GEThttps://api.getcovent.com/api/v1/walkthroughs?listing_id=lst_123&individual_id=ind_123&status=scheduled&starts_after=2026-04-20T00%3A00%3A00Z&page=1&page_size=25

Retrieve walkthroughs with optional filters for listing, individual, or schedule state.

How to Call

Use one of the examples below to call this endpoint from your own integration.

curl -X GET "https://api.getcovent.com/api/v1/walkthroughs?listing_id=lst_123&individual_id=ind_123&status=scheduled&starts_after=2026-04-20T00%3A00%3A00Z&page=1&page_size=25" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Request

Review headers, parameters, and body fields before calling this endpoint.

AuthorizationstringRequired

Bearer token for the proposed external API contract.

Example: Bearer <API_KEY>
AcceptstringRequired

Response format header.

Example: application/json

listing_idstringRequired

listing_id query parameter.

Example: lst_123
individual_idstringRequired

individual_id query parameter.

Example: ind_123
statusstringRequired

status query parameter.

Example: scheduled
starts_afterstringRequired

starts_after query parameter.

Example: 2026-04-20T00:00:00Z
pagenumberRequired

page query parameter.

Example: 1
page_sizenumberRequired

page_size query parameter.

Example: 25

Response

200application/json

itemsarrayRequired

items response field.

Example: [{"id":"wt_123","listing_id":"lst_123","individual_id":"ind_123","scheduled_at":"2026-04-21T17:00:00Z","status":"scheduled"}]
pagenumberRequired

page response field.

Example: 1
page_sizenumberRequired

page_size response field.

Example: 25
totalnumberRequired

total response field.

Example: 7

Response Example

{
  "items": [
    {
      "id": "wt_123",
      "listing_id": "lst_123",
      "individual_id": "ind_123",
      "scheduled_at": "2026-04-21T17:00:00Z",
      "status": "scheduled"
    }
  ],
  "page": 1,
  "page_size": 25,
  "total": 7
}