> ## Documentation Index > Fetch the complete documentation index at: https://docs.idmetagroup.com/llms.txt > Use this file to discover all available pages before exploring further. # Phone Social Insights > Gather social footprint intelligence for a phone number, including platform registration signals across ecommerce, messaging, and social media. ## OpenAPI ````yaml api-reference/openapi.json POST /api/v3/verifications/phone-social openapi: 3.0.3 info: title: IDmeta API description: IDmeta verification and integration API. license: name: MIT version: 1.0.0 servers: - url: https://{environment-subdomain}.idmetagroup.com description: Your environment (replace `{environment-subdomain}`) variables: environment-subdomain: default: integrate enum: - integrate - api.ph description: >- IDmeta environment subdomain. Use `api.ph` for portalph.idmetagroup.com and `integrate` for verify.idmetagroup.com. security: - bearerAuth: [] tags: - name: Processes description: Verification process endpoints - name: Trust Flow Links description: Trust Flow link generation endpoints - name: Compliance description: Compliance verification endpoints - name: Government Data description: Government data verification endpoints - name: Alternative Verifications description: Alternative verification and intelligence endpoints - name: OCR description: Document OCR extraction endpoints paths: /api/v3/verifications/phone-social: post: tags: - Alternative Verifications summary: Phone Social Insights description: >- Returns social footprint intelligence for a phone number, including platform registration signals across categories such as ecommerce, messaging, and social media. Powered by the Monnai [`PHONE_SOCIAL`](https://monnai.gitbook.io/monnai-docs/api-reference/global-risk-insights/v1.3-new/phone-social) insight package. Provide `country_code` (for example, `+60`) and `phone_number` without the country prefix. The response is returned under `data.social` with `summary` and `categories`. IDmeta maps these fields to Monnai internally—you do not send `userDetails`, `packages`, or `consentDetails` directly. operationId: phoneSocialInsightsV3 parameters: - name: Accept in: header required: false schema: type: string default: application/json - name: Content-Type in: header required: false schema: type: string default: application/json requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PhoneSocialInsightsRequest' examples: default: summary: Phone social insights request value: country_code: phone_number: trustFlowId: 0 trustValidationId: '{your_trust_validation_id}' responses: '200': description: Phone social insights completed successfully headers: Content-Type: schema: type: string example: application/json content: application/json: schema: $ref: '#/components/schemas/PhoneSocialInsightsResponse' example: success: true message: Phone social verification processed successfully data: social: summary: profilesRegistered: 5 namesFound: 0 photosFound: 0 profilesChecked: 14 communicationBreadth: 2 digitalFootprintDiversity: 5 digitalSophisticationIndex: 5 engagementDepthIndex: 3 whatsappProfileCompleteness: Partial subscriptionAffordabilityIndex: 2 totalFreePlatforms: 4 totalFullPaidPlatforms: 0 totalPartialPaidPlatforms: 1 overall: global: count: 5 ratio: 0.2879 local: count: 0 ratio: 0 total: count: 5 ratio: 0.2273 socialCommercialRatio: 1.5 categories: ECOMMERCE: global: count: 1 ratio: 1 registered: - amazon local: count: 0 ratio: 0 notRegistered: - flipkart - snapdeal - shopclues - quickr total: count: 1 ratio: 0.5 EMAIL_PROVIDER: global: count: 0 ratio: 0 local: count: 0 ratio: 0 total: count: 0 ratio: 0 LIFESTYLE: global: count: 0 ratio: 0 local: count: 0 ratio: 0 notRegistered: - housing - jeevansathi - nobroker total: count: 0 ratio: 0 MESSAGING: global: count: 1 ratio: 0.5 registered: - whatsapp profileDetails: whatsapp: privacyStatus: PRIVATE about: '' businessAccount: false local: count: 0 ratio: 0 total: count: 1 ratio: 0.3333 PROFESSIONAL: global: count: 1 ratio: 1 registered: - microsoft local: count: 0 ratio: 0 total: count: 1 ratio: 1 SERVICES: global: count: 0 ratio: 0 local: count: 0 ratio: 0 total: count: 0 ratio: 0 SOCIAL_MEDIA: global: count: 2 ratio: 0.6667 registered: - facebook - instagram notRegistered: - twitter local: count: 0 ratio: 0 total: count: 2 ratio: 0.6667 TRAVEL: global: count: 0 ratio: 0 local: count: 0 ratio: 0 notRegistered: - irctc total: count: 0 ratio: 0 verificationStatus: VERIFIED verificationStatusCode: 3 trustFlowId: 0 trustValidationId: '{your_trust_validation_id}' verificationType: phone_social metadata: null createdAt: components: schemas: PhoneSocialInsightsRequest: type: object required: - country_code - phone_number - trustFlowId - trustValidationId properties: country_code: type: string description: 'Country calling code for the phone number. Example: `+60`.' phone_number: type: string description: Phone number without the country code prefix. trustFlowId: type: integer description: Trust flow ID used when you created the trust validation. trustValidationId: type: string description: Trust validation ID returned from create trust validation. PhoneSocialInsightsResponse: type: object required: - success - message - data - verificationStatus - verificationStatusCode - trustFlowId - trustValidationId - verificationType properties: success: type: boolean message: type: string data: type: object description: >- Phone social intelligence returned for the submitted number. Fields are dynamic—omitted when no data is available. properties: social: $ref: '#/components/schemas/PhoneSocialInsightsSocial' verificationStatus: type: string verificationStatusCode: type: integer trustFlowId: type: integer trustValidationId: type: string verificationType: type: string metadata: nullable: true createdAt: type: string description: Timestamp when the verification was created. PhoneSocialInsightsSocial: type: object description: >- Social footprint summary and category-wise platform presence. Powered by Monnai `PHONE_SOCIAL`. All fields are dynamic and may be omitted when unavailable. additionalProperties: true properties: summary: $ref: '#/components/schemas/PhoneSocialInsightsSummary' categories: type: object description: >- Category-wise platform presence. Each key is a category such as `MESSAGING`, `SOCIAL_MEDIA`, `PROFESSIONAL`, `ECOMMERCE`, `EMAIL_PROVIDER`, `LIFESTYLE`, `SERVICES`, `TRAVEL`, `GAMBLING`, or `MERCHANT`. Values inside `registered` and `notRegistered` are platform identifiers. Platform coverage depends on region. additionalProperties: $ref: '#/components/schemas/PhoneSocialInsightsCategory' PhoneSocialInsightsSummary: type: object description: Aggregated digital footprint metrics for the phone number. additionalProperties: true properties: profilesRegistered: type: integer description: >- Total number of platforms where the phone is confirmed registered. Example: `3`. namesFound: type: integer description: 'Platforms where an associated name was found. Example: `0`.' photosFound: type: integer description: 'Platforms where an associated profile photo was found. Example: `0`.' profilesChecked: type: integer description: 'Total number of platforms evaluated for registration. Example: `10`.' communicationBreadth: type: integer description: >- Count of communication-related platforms where presence is detected. Example: `2`. digitalFootprintDiversity: type: integer description: >- Count of distinct digital footprint categories detected. Example: `3`. digitalSophisticationIndex: type: integer description: >- Composite indicator of overall digital maturity based on platform presence patterns. Index range: `0` to `10`. engagementDepthIndex: type: integer description: >- Profile richness indicator based on detected metadata (names, photos, details). Index range: `0` to `10`. whatsappProfileCompleteness: type: string description: >- WhatsApp profile enrichment completeness. Possible values: `Basic`, `Complete`, `Partial`, `Not Present`. subscriptionAffordabilityIndex: type: integer description: >- Index estimating affordability based on free vs paid platform presence. Index range: `0` to `10`. totalFreePlatforms: type: integer description: >- Number of free platforms where the phone is registered. Example: `2`. totalFullPaidPlatforms: type: integer description: >- Number of fully paid platforms where the phone is registered. Example: `1`. totalPartialPaidPlatforms: type: integer description: >- Number of freemium/partially paid platforms where the phone is registered. Example: `0`. overall: type: object description: Overall platform presence across global and local scopes. properties: global: $ref: '#/components/schemas/PhoneSocialInsightsPresenceMetrics' local: $ref: '#/components/schemas/PhoneSocialInsightsPresenceMetrics' total: $ref: '#/components/schemas/PhoneSocialInsightsPresenceMetrics' socialCommercialRatio: type: number format: float description: >- Ratio indicating balance between social and commercial/service platforms. Example: `3.00`. PhoneSocialInsightsCategory: type: object description: >- Category-wise summary of platform presence across `global`, `local`, and `total` scopes. additionalProperties: true properties: global: $ref: '#/components/schemas/PhoneSocialInsightsScope' local: $ref: '#/components/schemas/PhoneSocialInsightsScope' total: $ref: '#/components/schemas/PhoneSocialInsightsScope' PhoneSocialInsightsPresenceMetrics: type: object description: Count and ratio representing platform presence for a scope. properties: count: type: integer description: 'Number of registered platforms in this scope. Example: `3`.' ratio: type: number format: float description: >- Ratio/index representing platform presence in this scope. Index range: `0.0` to `1.0`. PhoneSocialInsightsScope: type: object description: >- Presence metrics for a single category scope. Optional `registered`, `notRegistered`, and `profileDetails` appear when available. additionalProperties: true properties: count: type: integer description: >- Number of platforms in this scope where the identifier is confirmed registered. Example: `2`. ratio: type: number format: float description: >- Ratio/index representing presence within the category scope. Index range: `0.0` to `1.0`. registered: type: array description: >- List of platform identifiers where the phone is registered. Example: `["facebook","instagram"]`. items: type: string notRegistered: type: array description: >- List of platform identifiers checked but not registered. Example: `["twitter"]`. items: type: string profileDetails: type: object description: >- Optional enriched profile-level details for supported platforms. Availability and fields vary by platform. additionalProperties: true properties: whatsapp: $ref: '#/components/schemas/PhoneSocialInsightsWhatsappProfile' PhoneSocialInsightsWhatsappProfile: type: object description: WhatsApp profile enrichment when publicly available. additionalProperties: true properties: photo: type: string description: >- URL of WhatsApp profile photo associated with the number, if available. privacyStatus: type: string description: >- WhatsApp profile privacy status. Possible values: `PUBLIC`, `PRIVATE`. about: type: string description: WhatsApp about/bio text, if available. businessAccount: type: boolean description: >- Indicates whether the WhatsApp account is a business account. Possible values: `true`, `false`. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: Use `Bearer {your_api_token}` in the Authorization header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.