Contact Cardv2

Get contact card (Coming Soon)

GET/me/numbers/{number}/contact-card

⚠️ COMING SOON - This endpoint is temporarily disabled while we stabilize this feature.

Get the personal contact card (Name & Photo) for the specified phone number. This is the identity that gets shared with contacts in iMessage.

Path parameters

numberRequiredstring

E.164 phone number (URL-encoded, e.g., %2B15551234567)

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

phone_numberoptionalstring

first_nameoptionalstring | null

last_nameoptionalstring | null

nameoptionalstring | null

Display name

avataroptionalstring | null

Base64-encoded JPEG/PNG image

has_wallpaperoptionalboolean

sharingoptionalobject

enabledoptionalboolean

Whether Name & Photo sharing is enabled

audienceoptionalinteger

0 = Contacts Only, 1 = Always Ask

name_formatoptionalinteger

0 = First & Last, 1 = First Only

Response codes

200Contact card data

400Invalid request parameters

401Authentication required or invalid

403Phone number not accessible with this API key

404Resource not found

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X GET https://api.blooio.com/v2/api/me/numbers/%2B15551234567/contact-card \  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "phone_number": "+15551234567",  "first_name": "Jane",  "last_name": "Doe",  "name": "Jane Doe",  "avatar": "https://example.com/image.jpg",  "has_wallpaper": true,  "sharing": {    "enabled": true,    "audience": 0,    "name_format": 0  }}