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

# Foto de Perfil

> Obtém a foto de perfil de um contato ou grupo

Obtém a URL da foto de perfil de um contato ou grupo.

## Query Parameters

<ParamField query="sessionId" type="string" required>
  ID da sessão.
</ParamField>

<ParamField query="jid" type="string" required>
  JID do contato ou grupo.
</ParamField>

<ParamField query="type" default="preview" type="string">
  Tipo de imagem.

  **Valores:**

  * `preview` - Imagem em baixa resolução (mais rápido)
  * `image` - Imagem em alta resolução
</ParamField>

## Resposta

<ResponseField name="success" type="boolean">
  Se a operação foi bem-sucedida.
</ResponseField>

<ResponseField name="jid" type="string">
  JID consultado.
</ResponseField>

<ResponseField name="url" type="string">
  URL da foto de perfil. `null` se não houver foto ou não for acessível.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X GET "https://api.oxenty.api.br/api/contacts/profile-picture?sessionId=550e8400-e29b-41d4-a716-446655440000&jid=5511999999999@s.whatsapp.net&type=image" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={"system"}
  const profile = await client.contacts.getProfilePicture(sessionId, {
    jid: '5511999999999@s.whatsapp.net',
    type: 'image',
  });

  if (profile.url) {
    console.log('Foto de perfil:', profile.url);
  } else {
    console.log('Contato sem foto de perfil');
  }
  ```

  ```python Python theme={"system"}
  profile = client.contacts.get_profile_picture(
      session_id,
      jid='5511999999999@s.whatsapp.net',
      type='image'
  )

  if profile['url']:
      print(f"Foto de perfil: {profile['url']}")
  else:
      print("Contato sem foto de perfil")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "success": true,
    "jid": "5511999999999@s.whatsapp.net",
    "url": "https://pps.whatsapp.net/v/t61.xxxxx/xxxxx.jpg"
  }
  ```

  ```json 200 OK (Sem foto) theme={"system"}
  {
    "success": true,
    "jid": "5511999999999@s.whatsapp.net",
    "url": null
  }
  ```
</ResponseExample>

<Note>
  A URL retornada é temporária e pode expirar após algumas horas. Para uso prolongado, baixe a imagem e armazene localmente.
</Note>