---
title: "Get Agent Incoming Call Action"
method: GET
path: "/api/v1/phone/incoming-call-action"
tags: ["Phone Calls"]
---

# Get Agent Incoming Call Action

`GET /api/v1/phone/incoming-call-action`

## Query parameters

- `agent_identity_id` string, uuid, nullable

## Response `200`

Successful Response

- IncomingCallActionResponse
  - `agent_identity_id` string, uuid, required
  - `incoming_call_action` 'auto_accept' | 'auto_reject' | 'webhook' | 'hosted_agent' | 'forward', required
  - `client_websocket_url` string, nullable, required
  - `incoming_call_webhook_url` string, nullable, required
  - `forwarding_target_type` 'phone' | 'sip'
  - `forwarding_phone_number` string, nullable
  - `forwarding_sip_uri` string, nullable

## Other responses

- `422` — Validation Error
- `4XX` — Client error with Support Agent information.
- `5XX` — Server error with Support Agent information.

---

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