Pular para o conteúdo principal
GET
/
api
/
profile
/
getAccount
/
:instance
Verificar conta
curl --request GET \
  --url https://api.example.com/api/profile/getAccount/:instance \
  --header 'token: <token>'
Auth: TokenAccount ou TokenInstance • Rate-limit: Global (100/min) • Idempotente: sim (read-only)

​
Descrição

Retorna os dados do perfil da própria conta conectada (foto, nome, status, JID, LID). Opcionalmente, consulta o perfil de outro número via ?number=. Sem o parâmetro, retorna o perfil da própria instância.

​
Exemplos

​
Própria conta

Sem query param: retorna o perfil da própria instância conectada (foto, nome, status, JID e LID). Forma direta de validar quem está conectado naquela sessão. 
curl -X GET "https://ryzeapi.cloud/api/profile/getAccount/$Instance_Name" \
  -H "token: $Token_Instance"

​
Outro número

Consulta o perfil público de um terceiro pelo número (?number=5511988887777). Útil para verificar se o número existe no WhatsApp e obter foto / nome / status visíveis ao público. 
curl -X GET "https://ryzeapi.cloud/api/profile/getAccount/$Instance_Name?number=5511988887777" \
  -H "token: $Token_Instance"

​
Por LID

Consulta o perfil usando um LID (@lid) em vez de número. Útil quando o evento de origem expõe apenas o LID anônimo (em comunidades / canais novos do WhatsApp), sem o telefone correspondente. 
curl -X GET "https://ryzeapi.cloud/api/profile/getAccount/$Instance_Name?number=52399087550579@lid" \
  -H "token: $Token_Instance"

​
Resposta de sucesso

Devolve profile com os dados do alvo: profilePicture (URL CDN do WhatsApp, sempre presente, vira null se a conta não tem foto ou o lookup deu timeout), profileName (push name ou business name), profileStatus (texto “Recados”), phoneNumber (só dígitos), jid (<numero>@s.whatsapp.net) e lid (formato @lid, quando disponível). Os campos exceto profilePicture usam omitempty, podem não aparecer se o WhatsApp não devolveu o dado.
200 OK
{
  "success": true,
  "message": "Profile information retrieved successfully",
  "profile": {
    "profilePicture": "https://pps.whatsapp.net/...",
    "profileName": "João Silva",
    "profileStatus": "Disponível",
    "phoneNumber": "5511999999999",
    "jid": "5511999999999@s.whatsapp.net",
    "lid": "199789077627112@lid"
  }
}
200 OK (sem foto)
{
  "success": true,
  "message": "Profile information retrieved successfully",
  "profile": {
    "profilePicture": null,
    "profileName": "Cliente Teste",
    "phoneNumber": "5511988887777",
    "jid": "5511988887777@s.whatsapp.net"
  }
}

​
Parâmetros de rota

​
instance
string
obrigatório
Nome da instância.

​
Headers

​
token
string
obrigatório
TokenAccount ou TokenInstance.

​
Query

​
number
string
Número (5511999999999, +5511999999999, 5511999999999@s.whatsapp.net) ou LID (52399087550579@lid). Se omitido, retorna o perfil da própria instância.

​
Notas

  • Para números BR (55...), o serviço tenta automaticamente variações com e sem o 9º dígito.
  • Sanitização automática de +, -, (, ) e espaços: (11) 99999-9999 vira 11999999999.
  • profilePicture é o único campo que sempre aparece (pode ser null); os demais usam omitempty.
  • A URL da foto é temporária (CDN do WhatsApp). Se o lookup ultrapassar 10s, o campo vem null.
  • Para a própria conta, prefira number="", passar o próprio número retorna dados “como outros te veem”.

​
Erros

HTTPMensagem
400Number not found or not registered on WhatsApp
400invalid LID format
400Instance is not connected to WhatsApp
500timeout ao buscar foto (>10s)
Envelope: 
{
  "success": false,
  "error": { "message": "Number not found or not registered on WhatsApp" }
}