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

# エージェントのステータスを取得

> Firecrawl APIキーが必要なAIエージェントの方は、自動オンボーディング手順について [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) を参照してください。


## OpenAPI

````yaml ja/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: Firecrawlのサービスを利用して、Webスクレイピングやクロールを行うためのAPIです。
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /agent/{jobId}:
    parameters:
      - description: エージェントジョブのID
        in: path
        name: jobId
        required: true
        schema:
          format: uuid
          type: string
    get:
      tags:
        - Agent
      summary: エージェントジョブのステータスを取得
      operationId: getAgentStatus
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  creditsUsed:
                    type: number
                  data:
                    description: >-
                      抽出されたデータ（ステータスが completed
                      の場合にのみ存在）。クレジット上限で停止した場合を含め、失敗した実行では設定されません。
                    type: object
                  effort:
                    description: エージェント実行で使用される推論予算（effort を設定した実行でのみ存在）
                    enum:
                      - low
                      - medium
                      - high
                    type: string
                  error:
                    description: エラーメッセージ（status が failed の場合にのみ含まれます）
                    type: string
                  expiresAt:
                    format: date-time
                    type: string
                  message:
                    description: >-
                      結果に関する Agent
                      からの補足。クレジット上限に達して実行が停止し、失敗した場合は、どの部分が未完了かが説明されることがあります。
                    type: string
                  model:
                    default: spark-2
                    description: >-
                      エージェント実行時に使用されたモデルプリセット。新しいすべての実行は spark-2 で実行されます。Spark 1
                      の名前はレガシー実行にのみ表示されます。
                    enum:
                      - spark-2
                      - spark-1-pro
                      - spark-1-mini
                    type: string
                  partial:
                    description: >-
                      未完了の実行から可能な範囲で復元された JSON。`maxCredits`
                      に達した場合など、一部の失敗した実行でのみ存在し、処理中の実行では存在しません。行やフィールドが欠落している可能性があるため、完了した結果として扱わないでください。
                  partialSchemaValid:
                    description: >-
                      `partial` がリクエストの JSON スキーマに適合するかどうか。`partial` が存在し、リクエストに
                      `schema` が含まれている場合にのみ存在します。
                    type: boolean
                  status:
                    enum:
                      - processing
                      - completed
                      - failed
                    type: string
                  stopReason:
                    description: >-
                      失敗した実行が途中で停止した理由。`credit_limit_reached` は、実行が `maxCredits`
                      の上限に達したことを意味します。ステータスが failed の場合にのみ存在します。
                    enum:
                      - credit_limit_reached
                    type: string
                  success:
                    type: boolean
                type: object
          description: 成功時のレスポンス
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Invalid job ID format. Job ID must be a valid UUID.
                    type: string
                type: object
          description: 不正なリクエスト — ジョブ ID が有効な UUID ではありません。
        '404':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Agent job not found
                    type: string
                type: object
          description: エージェントジョブが見つかりません
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

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