> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-iq666a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter status do agente

> Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para ver instruções automatizadas de onboarding.


## OpenAPI

````yaml pt-BR/api-reference/v2-openapi.json GET /agent/{jobId}
openapi: 3.0.0
info:
  contact:
    email: support@firecrawl.dev
    name: Firecrawl Support
    url: https://firecrawl.dev/support
  description: >-
    API para interagir com os serviços do Firecrawl e executar tarefas de web
    scraping e crawling.
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /agent/{jobId}:
    parameters:
      - description: O ID da tarefa do agente
        in: path
        name: jobId
        required: true
        schema:
          format: uuid
          type: string
    get:
      tags:
        - Agent
      summary: Obter o status de um job de agente
      operationId: getAgentStatus
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  creditsUsed:
                    type: number
                  data:
                    description: >-
                      Os dados extraídos (apenas presentes quando o status é
                      "completed"). Nunca definidos em uma execução que falhou,
                      inclusive quando ela foi interrompida ao atingir o limite
                      de créditos.
                    type: object
                  effort:
                    description: >-
                      Orçamento de raciocínio usado na execução do agente
                      (presente apenas em execuções que definem esforço)
                    enum:
                      - low
                      - medium
                      - high
                    type: string
                  error:
                    description: Mensagem de erro (apenas quando o status for "failed")
                    type: string
                  expiresAt:
                    format: date-time
                    type: string
                  message:
                    description: >-
                      Uma observação do agente sobre o resultado. Se a execução
                      falhou ao ser interrompida por atingir o limite de
                      créditos, pode explicar o que ficou incompleto.
                    type: string
                  model:
                    default: spark-2
                    description: >-
                      Predefinição de modelo usada na execução do agente. Todas
                      as novas execuções são realizadas no spark-2; os nomes do
                      Spark 1 aparecem apenas em execuções legadas.
                    enum:
                      - spark-2
                      - spark-1-pro
                      - spark-1-mini
                    type: string
                  partial:
                    description: >-
                      JSON recuperado, na medida do possível, de uma execução
                      incompleta. Presente apenas em algumas execuções que
                      falharam, como uma que atingiu `maxCredits`; nunca
                      presente enquanto a execução está em processamento. Pode
                      conter linhas ou campos faltantes, portanto não o trate
                      como um resultado completo.
                  partialSchemaValid:
                    description: >-
                      Indica se `partial` é válido segundo o schema JSON da
                      solicitação. Presente apenas quando há um `partial` e a
                      solicitação incluiu um `schema`.
                    type: boolean
                  status:
                    enum:
                      - processing
                      - completed
                      - failed
                    type: string
                  stopReason:
                    description: >-
                      Motivo pelo qual uma execução que falhou foi interrompida
                      antes do término. `credit_limit_reached` significa que a
                      execução atingiu o limite definido em `maxCredits`.
                      Presente apenas quando o status é failed.
                    enum:
                      - credit_limit_reached
                    type: string
                  success:
                    type: boolean
                type: object
          description: Resposta bem-sucedida
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Invalid job ID format. Job ID must be a valid UUID.
                    type: string
                type: object
          description: Solicitação inválida — o ID do job não é um UUID válido.
        '404':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Agent job not found
                    type: string
                type: object
          description: Job do agente não encontrado
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

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