> ## 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.

# Consultar comando assíncrono

> Consulta o estado e o resultado de um comando enviado com `async: true`, pelo `commandId` retornado no enfileiramento.

`status`: `queued` (na fila), `processing` (executando), `completed` (executou — veja `result.success` para saber se o comando deu certo) ou `failed` (o worker falhou; veja `error`).

O resultado fica disponível por uma janela limitada de retenção da fila; para entrega garantida use o webhook `command.result`.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/commands/{commandId}
openapi: 3.1.0
info:
  title: D-API - Infraestrutura WhatsApp Completa
  description: >-
    Solução escalável e robusta para gestores de automação, SaaS e usuários
    finais que precisam de uma integração WhatsApp confiável. Oferece múltiplas
    instâncias simultâneas, webhooks em tempo real, dashboard intuitivo e API
    REST documentada com 99.9% de uptime e latência inferior a 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: Produção
security:
  - ApiKeyAuth: []
tags:
  - name: Início
    description: Endpoints base
  - name: Sessões
    description: Endpoints para gerenciamento de sessões
  - name: Mensagens
    description: Endpoints para envio de mensagens
  - name: Cloud API
    description: >-
      WhatsApp API Oficial (Meta Cloud API): conexão manual, gestão de templates
      (listar/criar/excluir) e envio de templates.
  - name: Ligações URA
    description: >-
      Disparo de ligações de voz (URA): individual ou em massa, com áudio ou
      fluxo IVR.
  - name: SMS
    description: 'Envio de SMS: individual ou em massa.'
  - name: Comandos
    description: >-
      Consulta de comandos assíncronos (async: true) pelo commandId retornado no
      enfileiramento.
paths:
  /api/v1/commands/{commandId}:
    get:
      tags:
        - Comandos
      summary: Consultar comando assíncrono
      description: >-
        Consulta o estado e o resultado de um comando enviado com `async: true`,
        pelo `commandId` retornado no enfileiramento.


        `status`: `queued` (na fila), `processing` (executando), `completed`
        (executou — veja `result.success` para saber se o comando deu certo) ou
        `failed` (o worker falhou; veja `error`).


        O resultado fica disponível por uma janela limitada de retenção da fila;
        para entrega garantida use o webhook `command.result`.
      operationId: getApiV1CommandsByCommandId
      parameters:
        - schema:
            minLength: 1
            type: string
          in: path
          name: commandId
          required: true
      responses:
        '200':
          description: Resposta bem-sucedida
        '404':
          description: >-
            Comando inexistente, expirado da fila ou fora do escopo da
            credencial
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API Key para autenticação. Formato: <API_KEY>'

````