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

# Obter URL da Foto de Perfil do Contato

> Obter URL da foto de perfil de um contato

## Descrição

Este endpoint retorna a URL da foto de perfil de um contato específico no WhatsApp. A URL retornada pode ser usada para baixar ou exibir a imagem de perfil.

## Query Parameters

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

<ParamField query="jid" type="string" required>
  Identificador do contato (JID do WhatsApp). Formato: `5511999999999@s.whatsapp.net`
</ParamField>

<ResponseExample>
  ```json Resposta de Sucesso theme={null}
  {
    "url": "https://pps.whatsapp.net/v/t61.24694-24/...",
    "id": "1234567890",
    "type": "image"
  }
  ```
</ResponseExample>

## Códigos de Status

* `200` - URL da foto retornada com sucesso
* `400` - Parâmetros inválidos
* `401` - Sessão não autorizada
* `404` - Sessão, contato não encontrado ou contato sem foto de perfil

## Exemplo de Uso

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.wappfy.com.br/api/contacts/profile-picture?sessionId=my-session&jid=5511999999999@s.whatsapp.net"
  ```

  ```javascript JavaScript theme={null}
  const sessionId = 'my-session';
  const jid = '5511999999999@s.whatsapp.net';
  const response = await fetch(
    `https://api.wappfy.com.br/api/contacts/profile-picture?sessionId=${sessionId}&jid=${jid}`
  );
  const data = await response.json();
  console.log(`URL da foto: ${data.url}`);

  // Baixar a imagem
  const imageResponse = await fetch(data.url);
  const imageBlob = await imageResponse.blob();
  console.log('Imagem baixada com sucesso!');
  ```

  ```python Python theme={null}
  import requests

  session_id = 'my-session'
  jid = '5511999999999@s.whatsapp.net'
  response = requests.get(
      'https://api.wappfy.com.br/api/contacts/profile-picture',
      params={
          'sessionId': session_id,
          'jid': jid
      }
  )
  data = response.json()
  print(f"URL da foto: {data['url']}")

  # Baixar a imagem
  image_response = requests.get(data['url'])
  with open('profile.jpg', 'wb') as f:
      f.write(image_response.content)
  print('Imagem salva como profile.jpg')
  ```
</CodeGroup>


## OpenAPI

````yaml viewer.json get /api/contacts/profile-picture
openapi: 3.1.0
info:
  title: Wappfy - WhatsApp HTTP API
  version: '2.0'
  contact: {}
servers:
  - url: https://{host}
    description: Servidor Customizável
    variables:
      host:
        default: api.wappfy.com.br
        description: 'URL do servidor (ex: api.wappfy.com.br ou seu-servidor.com)'
security:
  - api_key: []
tags:
  - name: 🖥️ Sessions
    description: >-
      Controlar sessões do WhatsApp (contas) (Control WhatsApp sessions
      (accounts))
  - name: 🔑 Auth
    description: Autenticação
  - name: 🆔 Profile
    description: Informações do seu perfil
  - name: 🖼️ Screenshot
    description: Obter captura de tela do WhatsApp e mostrar código QR
  - name: 📤 Chatting
    description: Métodos de conversação
  - name: 📢 Channels
    description: Métodos de canais (newsletters) (Channels (newsletters) methods)
  - name: 🟢 Status
    description: Métodos de status (aka stories) (Status (aka stories) methods)
  - name: 💬 Chats
    description: Métodos de conversas
  - name: 👤 Contacts
    description: >-
      Métodos de contatos. Use número de telefone (sem +) ou número de telefone
      e `@c.us` no final como `contactId`. Ex: `12312312310` OU
      `12312312310@c.us` (Contacts methods.<br>
                      Use phone number (without +) or phone number and `@c.us` at the end as `contactId`.<br>
                      'E.g: `12312312310` OR `12312312310@c.us`<br>)
  - name: 👥 Groups
    description: Métodos de grupos (Groups methods).<br>
  - name: ✅ Presence
    description: Informações de presença
  - name: 📅 Events
    description: Mensagem de Evento
  - name: 🏷️ Labels
    description: Etiquetas - disponível apenas para contas WhatsApp Business
  - name: 🔍 Observability
    description: Outros métodos
  - name: 🗄️ Storage
    description: Métodos de armazenamento
externalDocs:
  description: Wappfy - WhatsApp HTTP API
  url: https://wappfy.com.br/
paths:
  /api/contacts/profile-picture:
    get:
      tags:
        - 👤 Contacts
      summary: Obter URL da foto de perfil do contato
      description: >-
        Se as configurações de privacidade não permitirem obter a imagem, o
        método retornará null
      operationId: ContactsController_getProfilePicture
      parameters:
        - name: contactId
          required: true
          in: query
          example: 5511999999999@c.us
          schema:
            type: string
        - name: refresh
          required: false
          in: query
          example: false
          description: >-
            Atualizar a foto do servidor (cache de 24h por padrão). Não atualize
            se não for necessário, você pode ter erro de limite de taxa (Refresh
            the picture from the server (24h cache by default). Do not refresh
            if not needed, you can get rate limit error)
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: ''
      security:
        - api_key: []
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: apikey
      description: Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)

````