> ## Documentation Index
> Fetch the complete documentation index at: https://docs.d-api.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Get contact info

> A contact's data, with picture and WhatsApp Business profile.

Returns a contact's data: names, `username`, whether the account is Business
(`isBusiness`) or Official API (`isOfficial`), about text (`status`) and picture
(`avatar`). `POST /api/v1/contacts/getuser` returns the same response, with the
parameters in the body.

## WhatsApp Business profile

When the contact is a business account (WhatsApp Business app or Official API),
the response carries `data.businessProfile` with the public business profile:
description, email, address, websites, location, categories, business hours,
linked Instagram and Facebook accounts, offerings and cover photo.

The profile comes **by default**. It costs one extra query to WhatsApp (up to
10 s); if you don't need it, turn it off with `business=false` (query) on `GET`
or `"business": false` (body) on `POST`.

> [!NOTE]
>
> `businessProfile` only exists for business accounts and when the lookup
> succeeds. For a personal contact, with `business=false` or when WhatsApp does
> not answer in time, the key is **absent** — the rest of the contact arrives
> as usual. Treat the field as optional.

```json theme={null}
{
  "success": true,
  "commandId": "b7e2c1d4-5f60-4a8b-9c3d-1e2f3a4b5c6d",
  "data": {
    "jid": "5511988887777@s.whatsapp.net",
    "phone": "5511988887777",
    "lid": "163896103039140@lid",
    "contactName": "Minha Empresa",
    "pushName": "Minha Empresa",
    "username": "",
    "isBusiness": true,
    "isOfficial": false,
    "isOnWhatsApp": true,
    "status": "Open Monday to Saturday",
    "avatar": "https://s3.us-east-005.backblazeb2.com/d-api-media/avatars/5511988887777.jpg",
    "businessProfile": {
      "description": "Agência de marketing digital",
      "email": "contato@minhaempresa.com.br",
      "address": "Avenida Paulista, 1000, São Paulo SP",
      "websites": ["https://minhaempresa.com.br", "https://loja.minhaempresa.com.br/"],
      "location": { "latitude": -23.5632, "longitude": -46.6543 },
      "categories": [{ "id": "123377808095874", "name": "Agência de marketing" }],
      "businessHours": {
        "timezone": "America/Sao_Paulo",
        "days": [
          { "dayOfWeek": "mon", "mode": "specific_hours", "openTime": "08:00", "closeTime": "12:00" },
          { "dayOfWeek": "mon", "mode": "specific_hours", "openTime": "13:30", "closeTime": "18:00" },
          { "dayOfWeek": "sat", "mode": "appointment_only", "openTime": "", "closeTime": "" }
        ]
      },
      "instagram": {
        "handle": "minhaempresa",
        "followers": 1494,
        "url": "https://www.instagram.com/minhaempresa/"
      },
      "facebook": {
        "id": "1132445806627829",
        "name": "Minha Empresa",
        "likes": 17,
        "url": "https://www.facebook.com/1132445806627829"
      },
      "offerings": [
        {
          "category": "Opções de pagamento e estacionamento",
          "items": [{ "id": "business_pix_accepted", "name": "Aceitamos Pix", "offered": true }]
        }
      ],
      "coverPhotoUrl": "https://media.cdn.whatsapp.net/v/t61.24694-24/...",
      "commerceExperience": "catalog",
      "cartEnabled": true,
      "accountType": "smb",
      "verificationLevel": "unknown",
      "automatedType": "unknown",
      "memberSince": "2023-07-03T19:35:10Z",
      "memberSinceText": "Empresa cadastrada desde julho, 2023."
    }
  },
  "timestamp": "2026-11-05T22:10:00.000Z"
}
```

### `businessProfile` fields

**description** `string`

Business description

**email** `string`

Public email

**address** `string`

Address

**websites** `string[]`

Registered websites (empty list when there are none). Some businesses put
their Instagram link here instead of linking the account.

**location** `object | null`

`{ latitude, longitude }` of the location pinned on the profile, or `null`

**categories** `object[]`

Business categories: `{ id, name }`

**businessHours** `object`

**businessHours fields**

**timezone** `string`

Time zone of the business hours (e.g. `America/Sao_Paulo`)

**days** `object[]`

One entry per time range. A split shift (e.g. morning and afternoon)
produces **two entries for the same day**.

**days fields**

**dayOfWeek** `string`

`mon` | `tue` | `wed` | `thu` | `fri` | `sat` | `sun`

**mode** `string`

`specific_hours` (set hours) | `open_24h` (24 hours) |
`appointment_only` (by appointment only)

**openTime** `string`

Opening time as `HH:MM`. Empty unless `mode` is `specific_hours`

**closeTime** `string`

Closing time as `HH:MM`. Empty unless `mode` is `specific_hours`

**instagram** `object | null`

Linked Instagram account: `{ handle, followers, url }`, or `null`

**facebook** `object | null`

Linked Facebook page: `{ id, name, likes, url }`, or `null`

**offerings** `object[]`

Services and amenities checked on the profile, grouped by category:
`{ category, items: [{ id, name, offered }] }`

**coverPhotoUrl** `string`

Cover photo. It is a signed WhatsApp CDN link that **expires** — download the
image if you need to keep it.

**commerceExperience** `string`

`catalog` | `shop` | `none`

**cartEnabled** `boolean`

Whether the shopping cart is enabled

**accountType** `string`

`smb` (WhatsApp Business app) | `ent` (API / hosted account)

**verificationLevel** `string`

Verification level reported by WhatsApp

**automatedType** `string`

Automation type reported by WhatsApp

**memberSince** `string`

When the business signed up, in RFC 3339, or empty when WhatsApp does not say

**memberSinceText** `string`

The same information as text, as WhatsApp displays it


## OpenAPI

````yaml api-reference/openapi.en.json GET /api/v1/contacts/{phone}
openapi: 3.1.0
info:
  title: D-API - Complete WhatsApp Infrastructure
  description: >-
    A scalable, robust solution for automation managers, SaaS products and end
    users who need a reliable WhatsApp integration. It offers multiple
    simultaneous instances, real-time webhooks, an intuitive dashboard and a
    documented REST API with 99.9% uptime and latency under 30ms.
  version: 1.2.1
  contact:
    name: Suporte D-API
    email: suporte@d-api.cloud
    url: https://d-api.cloud
servers:
  - url: https://api.d-api.cloud
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Home
    description: Base endpoints
  - name: Sessions
    description: Endpoints for managing sessions
  - name: Messages
    description: Endpoints for sending messages
  - name: Cloud API
    description: >-
      WhatsApp Official API (Meta Cloud API): manual connection, template
      management (list/create/delete) and template sending.
  - name: IVR Calls
    description: 'Voice call dispatch (IVR): single or bulk, with audio or an IVR flow.'
  - name: SMS
    description: 'SMS sending: single or bulk.'
  - name: Commands
    description: >-
      Look up asynchronous commands (async: true) by the commandId returned when
      enqueued.
paths:
  /api/v1/contacts/{phone}:
    get:
      tags:
        - Contacts
      summary: Get user info
      description: >-
        Gets a contact's data. Fields: jid, phone, lid, contactName (name saved
        in your address book), pushName (name the contact publishes: profile,
        business or verified name), username (WhatsApp @handle), isBusiness
        (WhatsApp Business account on the phone), isOfficial (Meta-hosted
        account, i.e. Official API), isOnWhatsApp, status and avatar (URL
        persisted in S3). A number not on WhatsApp comes back as { phone,
        isOnWhatsApp: false }. Business accounts also get businessProfile:
        description, email, address, websites, location, categories,
        businessHours (timezone + days with openTime/closeTime as HH:MM),
        instagram { handle, followers, url }, facebook { id, name, likes, url },
        offerings, coverPhotoUrl (temporary link), commerceExperience,
        cartEnabled, accountType (smb = Business app, ent = API),
        verificationLevel, automatedType, memberSince and memberSinceText.
        avatar=false skips fetching the picture; force=true bypasses the avatar
        cache; preview=true returns the low-resolution picture; business=false
        skips the business profile.
      operationId: getApiV1ContactsByPhone
      parameters:
        - schema:
            type: string
          in: path
          name: phone
          required: true
        - schema:
            minLength: 1
            type: string
          in: query
          name: sessionId
          required: true
        - schema:
            anyOf:
              - type: boolean
              - type: string
          in: query
          name: async
          required: false
        - schema:
            type: string
          in: query
          name: avatar
          required: false
        - schema:
            type: string
          in: query
          name: force
          required: false
        - schema:
            type: string
          in: query
          name: preview
          required: false
        - schema:
            type: string
          in: query
          name: business
          required: false
      responses:
        '200':
          description: Successful response
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API Key for authentication. Format: <API_KEY>'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.