Skip to content
Sendblue Docs
Get Started
API Reference
Lines
Call Forwarding

Get call forwarding for a line

lines.call_forwarding.retrieve(strsendblue_number) -> CallForwardingRetrieveResponse
GET/api/lines/{sendblue_number}/call-forwarding

Returns the current call forwarding number for a dedicated phone line.

Per-line forwarding takes priority over the company default forwarding number but is overridden by seat-level forwarding when a seat has a forwarding number set.

Priority order: seat forwarding → per-line forwarding → company default forwarding

ParametersExpand Collapse
sendblue_number: str
ReturnsExpand Collapse
class CallForwardingRetrieveResponse: …
forwarding_number: Optional[str]

The number calls are forwarded to, or null if not set

sendblue_number: str

The Sendblue phone number (E.164)

Get call forwarding for a line

import os
from sendblue_api import SendblueAPI

client = SendblueAPI(
    api_key=os.environ.get("SENDBLUE_API_API_KEY"),  # This is the default and can be omitted
    api_secret=os.environ.get("SENDBLUE_API_API_SECRET"),  # This is the default and can be omitted
)
call_forwarding = client.lines.call_forwarding.retrieve(
    "+12125550101",
)
print(call_forwarding.forwarding_number)
{
  "forwarding_number": "+16692138010",
  "sendblue_number": "+12125550101"
}
Returns Examples
{
  "forwarding_number": "+16692138010",
  "sendblue_number": "+12125550101"
}