STstuut
business-identities

List Business Identities

List the organization's verified legal entities, one per Twilio Secondary Profile.

Unpaginated on purpose: the largest tenant has five, and the caller needs all of them to group.

get/v2/business-identities

Request

  • Base URL
    https://api.stuut.ai (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Response

Successful Response

created_atstring date-time required
modified_atstring date-time nullable required
idstring required
display_namestring nullable required

Verified legal entity name, read from Twilio; null when Twilio is unreachable.

cnam_display_namestring nullable required

Name shown on calls from this identity's numbers (CNAM), read from Twilio.

verification_status'draft' | 'pending_review' | 'in_review' | 'twilio_approved' | 'twilio_rejected' required

Verification state of a business identity's Twilio Secondary Profile.

Member names mirror Twilio's vocabulary, so the only difference from its wire strings is the separator — Twilio hyphenates (twilio-approved) where a Python name can't. from_twilio converts on that one character, which keeps the hyphenated spelling out of the enum, the column (which stores the NAME) and our API without a lookup table to keep in sync.

rejection_reasonstring nullable required

Why Twilio rejected the profile, when it did.

has_cnamboolean required

A CNAM registration exists for this identity.

has_shakenboolean required

SHAKEN/STIR attestation exists (US numbers only).

has_voice_integrityboolean required

Voice Integrity spam-label monitoring exists.

is_org_levelboolean required

This is the organization's own identity rather than a business unit's.

objectstring required

String representing the object's type. Objects of the same type share the same value.

Changes

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