Phone Numbers

Which agent answers a number

Who picks up when this number is called.

A number lives on the company profile as free text while the agent that answers it is bound on that agent's identity, so the link is not readable from either side alone. This resolves it.

READ-ONLY by design, and the design is load-bearing: resolving a route for real marks directory members as engaged, so this deliberately does not.

get/voice/numbers/answering-agent

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/voice/numbers/answering-agent
  • Auth: HTTP bearer

Query parameters

numberstring

The number to resolve, E.164. OPTIONAL: with no main line set yet, omitting it returns the organisation's receptionists, which is exactly the list to choose one from.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

dataPhoneNumberPayload required

An open envelope for a purchase result, a release, or an A2P job.

Open on purpose. A purchase returns the stored row (whose capability and provider-metadata keys differ per provider), a workflow start returns a workflow_id, and the A2P reconcile returns per-number outcomes that grow as carriers add statuses. Pinning it would silently drop whatever the provider reported that this contract had not caught up on.

Changes

No recorded changes to this operation across all 2 revisions of this API.