---
title: "Get a list of advertised interviews"
method: GET
path: "/api/list"
tags: ["Interviews"]
---

# Get a list of advertised interviews

`GET /api/list`

Returns interviews advertised by the system through the `dispatch`
configuration directive.

## Query parameters

- `tag` string
- `absolute_urls` 0 | 1

## Response `200`

List of advertised interviews.

- InterviewListItem[]
  - `filename` string
  - `link` string
  - `package` string
  - `status_class` string, nullable
  - `subtitle` string, nullable
  - `subtitle_class` string, nullable
  - `tags` string[]
  - `title` string

## Other responses

- `403` — Access denied.

---

[API](https://skmtc.dev/docassemble/apis/docassemble-api.md) · [All operations](https://skmtc.dev/docassemble/apis/docassemble-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docassemble/docassemble-api/revisions/a75d7eea6826/schema)