> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # Task abrufen > Einen Task per id pollen. Endergebnisse sind 24 Stunden nach Abschluss verfügbar. ## OpenAPI ````yaml GET /v1/async/task/{id} openapi: 3.1.0 info: title: querying.ai description: >- One API for every AI answer engine. Every task is asynchronous: submit, then collect the result via webhook or polling. version: 1.0.0 servers: - url: https://api.querying.ai description: Production security: - bearerAuth: [] paths: /v1/async/task/{id}: get: tags: - Tasks summary: Get a task description: >- Fetch a task by id. `response` is absent until the task reaches a terminal state. Tasks are retained for 24 hours, after which this returns `404`. operationId: getTask parameters: - name: id in: path required: true description: The task id returned at submit time. schema: type: string format: uuid responses: '200': description: The task, plus `response` or `error` once terminal. content: application/json: schema: $ref: '#/components/schemas/TaskResponse' examples: queued: summary: Still queued — no response yet value: success: true task: id: 8f2c1e40-0000-0000-0000-000000000000 taskType: GEMINI status: QUEUED priority: 1 createdAt: '2026-07-09T04:12:00.000Z' credits: creditsToCharge: 0 creditsCharged: 0 completed: summary: Completed value: success: true task: id: 8f2c1e40-0000-0000-0000-000000000000 taskType: GEMINI status: COMPLETED priority: 1 createdAt: '2026-07-09T04:12:00.000Z' credits: creditsToCharge: 0 creditsCharged: 0 response: text: The best wireless earbuds in 2026 are ... sources: - position: 1 url: https://example.com/review label: Best earbuds, reviewed failed: summary: Failed — note `error` is a string here, not an object value: success: true task: id: 8f2c1e40-0000-0000-0000-000000000000 taskType: GEMINI status: FAILED priority: 1 createdAt: '2026-07-09T04:12:00.000Z' credits: creditsToCharge: 0 creditsCharged: 0 error: >- ENGINE_TIMEOUT: The engine did not answer before the task deadline. '401': $ref: '#/components/responses/Unauthorized' '404': description: >- Unknown task id, or the task aged out of the 24-hour retention window. The two cases are indistinguishable. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: RESOURCE_NOT_FOUND message: Task not found details: id: 8f2c1e40-0000-0000-0000-000000000000 timestamp: '2026-07-09T04:12:00.000Z' components: schemas: TaskResponse: type: object required: - success - task - credits properties: success: type: boolean const: true task: $ref: '#/components/schemas/TaskMeta' credits: $ref: '#/components/schemas/Credits' response: type: object description: >- The engine-specific result. Absent until the task is terminal. See the Engines guide for per-engine shapes. SOURCE_INFLUENCE (and CITATION_ATTRIBUTION alias) returns SourceInfluenceResult; see the Source Influence guide. PROMPT_RESEARCH returns PromptResearchResult; see the Prompt Research guide. additionalProperties: true error: type: string description: >- Present when `task.status` is `FAILED`. A plain string — not the `{code, message, timestamp}` object used by request-level errors. ErrorResponse: type: object required: - success - error properties: success: type: boolean const: false error: $ref: '#/components/schemas/ErrorDetail' TaskMeta: type: object required: - id - taskType - status - priority - createdAt properties: id: type: string format: uuid taskType: $ref: '#/components/schemas/TaskType' status: $ref: '#/components/schemas/TaskStatus' priority: type: integer createdAt: type: string format: date-time idempotencyKey: type: string description: >- Echoed back verbatim. **Omitted** — not null — when the caller supplied none. Credits: type: object description: >- Submit and polling envelopes preserve zero values. With billing enabled, account settlement uses the engine pricing policy; webhooks report the persisted charge. SOURCE_INFLUENCE is metered by actual usage. properties: creditsToCharge: type: integer creditsCharged: type: - integer - 'null' ErrorDetail: type: object required: - code - message properties: code: type: string description: Stable, safe to branch on. enum: - MISSING_API_KEY - VALIDATION_ERROR - REGION_UNAVAILABLE - RESOURCE_ALREADY_EXISTS - PAYLOAD_TOO_LARGE - RESOURCE_NOT_FOUND - ENQUEUE_ERROR message: type: string description: For humans. May change. details: description: >- Field-level context. An array of `{field, message}` on `VALIDATION_ERROR`; an object on `RESOURCE_NOT_FOUND` (`{id}`) and `REGION_UNAVAILABLE`. Omitted when there is nothing to add. oneOf: - type: array items: type: object properties: field: type: string message: type: string - type: object additionalProperties: true timestamp: type: string format: date-time TaskType: type: string description: >- The engine to query. `NAVER` is a deprecated alias for `NAVER_AI_BRIEF`. GOOGLE_AIO and GOOGLE_AIMODE are the unified names for GOOGLE and AIMODE; both spellings are accepted and responses echo the canonical GOOGLE / AIMODE. `GOOGLE_SERP` returns the Google results page without the AI Overview; `payload.page` selects pages 1-10. `NAVER_SERP` returns Naver's web results, 15 per page (`payload.page` 1-10), and with `payload.action` `page` reads one naver.com page by `payload.url`. `REDDIT` searches Reddit posts by `query` (optionally within one `subreddit`), reads one post with its first page of comments by `url`, or lists posts with `action` `feed` or `user_posts`. `BING` and `BING_COPILOT_SEARCH` are accepted as earlier spellings of `BING_SEARCH`, and `COPILOT` as the earlier spelling of `BING_COPILOT`; responses echo the new names. SOURCE_INFLUENCE and PROMPT_RESEARCH tasks are created through their own endpoints (POST /v1/source-influence, POST /v1/prompt-research); they appear here because their tasks report them. enum: - CHATGPT - PERPLEXITY - GEMINI - AIMODE - GOOGLE_AIMODE - GOOGLE - GOOGLE_AIO - GOOGLE_SERP - NAVER_AI_BRIEF - NAVER_AI_TAB - NAVER - NAVER_SERP - BING_SEARCH - BING - BING_COPILOT - COPILOT - REDDIT - SOURCE_INFLUENCE - CITATION_ATTRIBUTION - PROMPT_RESEARCH TaskStatus: type: string description: >- `PROCESSING` means a worker holds the task. `COMPLETED` and `FAILED` are terminal. enum: - QUEUED - PROCESSING - COMPLETED - FAILED responses: Unauthorized: description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: MISSING_API_KEY message: Missing or invalid API key timestamp: '2026-07-09T04:12:00.000Z' securitySchemes: bearerAuth: type: http scheme: bearer description: 'Your API key, sent as `Authorization: Bearer `.' ````