---
title: "list_interviews"
method: POST
path: "/list_interviews"
tags: ["interviews"]
---

# list_interviews

`POST /list_interviews`

## Request

- Base URL: `https://app.podmule.com/api/v1`
- URL: `https://app.podmule.com/api/v1/list_interviews`
- Auth: HTTP bearer

List interview bookings in the active workspace, sorted by scheduled start time. Filter by show, contact, list of contact_ids, status, or date range. IMPORTANT status semantics: "confirmed" stays confirmed regardless of whether the date is in the past — it does NOT auto-transition to "completed" once the scheduled time passes. Use status="confirmed" without a date filter when the user wants past+future confirmed bookings. Use the contact_ids array filter (not the single contact_id) when you have a set of contacts (e.g., from search_contacts with a group filter) and want to find their bookings — one call instead of N.

## Request body

- unknown

## Response `200`

Capability output wrapped in `{ data }`.

- object
  - `data` unknown, required

## Other responses

- `400`: Invalid input — Zod validation failed.
- `401`: Missing, malformed, or audience-mismatched bearer token.
- `403`: Token is valid but lacks the required scope.
- `404`: Capability not registered, or referenced resource not found.
- `429`: Rate limit exceeded. Retry after the period in `Retry-After`.
- `500`: Internal error.

---

[API](https://skmtc.dev/podmule/apis/podmule-api.md) · [All operations](https://skmtc.dev/podmule/apis/podmule-api/llms.txt) · [OpenAPI document](https://skmtc.dev/podmule/apis/podmule-api/revisions/844ae61495fa?raw)