---
title: "Call Eligibility"
method: GET
path: "/api/v2/phone-service/call-eligibility"
tags: ["api-v2-phone-service"]
---

# Call Eligibility

`GET /api/v2/phone-service/call-eligibility`

## Request

- Base URL: `https://api.lev.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lev.com/api/v2/phone-service/call-eligibility`
- Auth: none declared

Whether an incoming call may still be connected to this broker for this company.

A broker who cannot be rung is a 200 saying so, not a failure: the phone service has to tell
"not allowed" from "we could not find out", and the two lead to different recorded outcomes.

## Query parameters

- `account_id` integer, required
- `user_id` integer, required

## Response `200`

Successful Response

- CallEligibilityResponse: Whether the phone service may connect an incoming call to this broker for this company.
  - `eligible` boolean, required: Whether this broker may be rung for this company right now
  - `reason` string, nullable: Stable reason a broker may not be rung, for recording why a call was not connected
  - `user_name` string, nullable: The broker's name, for greeting a caller who reaches their voicemail
  - `account_name` string, nullable: The company's name, for greeting a caller who reaches the broker's voicemail

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-25** `04c60da269dc`: 2 info
  - added the optional property `account_name` to the response with the `200` status
  - added the optional property `user_name` to the response with the `200` status
- **2026-09-18** `717348e9ff46`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lev/apis/lev-api/changes/api/v2/phone-service/call-eligibility/get.md)

---

[API](https://skmtc.dev/lev/apis/lev-api.md) - [All operations](https://skmtc.dev/lev/apis/lev-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lev/apis/lev-api/revisions/6330d0ef0603?raw)