---
title: "Get Screening Status"
method: GET
path: "/calls/screening/{screening_id}/status"
tags: ["Calls"]
---

# Get Screening Status

`GET /calls/screening/{screening_id}/status`

Get screening status for bot polling.

The bot should poll this endpoint every 1-2 seconds to check
if the screening call has been accepted or declined.

Requires agent token authentication.

Returns:
- **screening_id**: UUID of the screening request
- **status**: Current status (pending, accepted, declined, no_answer, failed)
- **updated_at**: When the status was last updated

## Path parameters

- `screening_id` string, uuid, required

## Response `200`

Successful Response

- ScreeningStatusResponse — Response with current screening status (for bot polling).
  - `screening_id` string, uuid, required — The ID of the screening request
  - `status` string, required — Current status: pending, accepted, declined, no_answer, failed
  - `decline_reason` string, nullable — Transcribed reason for declining (if user provided one)
  - `updated_at` string, date-time, nullable — When the status was last updated

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/4a81645b59f6/schema)