> ## Documentation Index > Fetch the complete documentation index at: https://docs.wibbleai.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a job > Fetch the current state of a humanization job and read its output. ## OpenAPI ````yaml openapi.yaml GET /humanize/{id} openapi: 3.1.0 info: title: Wibble API description: >- Public HTTP API for the Wibble humanizer. The humanizer runs asynchronously. You submit text to `POST /humanize`, which reserves the required API words up front and returns a job (HTTP `202`). You then either poll `GET /humanize/{id}` until the job reaches a terminal state (`succeeded` or `failed`), or register a `webhook_url` to be notified when the job finishes. Reserved words are refunded automatically if a job fails. ## Authentication All requests require a Bearer API key in the `Authorization` header. Keys look like `wib_live_...` and are created in the Wibble dashboard. A key must carry the `humanize` scope to use these endpoints. Treat API keys as server-side secrets. The v1 API is designed for server-to-server use and does not expose browser CORS access. ## Limits - Input text: up to **50,000** characters and up to **2,000** words per request. - Request body: up to **128,000** bytes. - Concurrency: up to **5** active jobs per account at once. - Rate limits: **20** submissions/minute (`POST`) and **120** lookups/minute (`GET`) per key. - Idempotency keys are retained for **24** hours. version: 1.0.0 contact: name: Wibble Support url: https://www.wibbleai.com license: name: Proprietary url: https://www.wibbleai.com servers: - url: https://www.wibbleai.com/api/v1 description: Production security: - bearerAuth: [] tags: - name: Humanize description: Submit and retrieve humanization jobs. paths: /humanize/{id}: get: tags: - Humanize summary: Retrieve a humanization job description: >- Fetch the current state of a humanization job. Poll this endpoint until `status` reaches a terminal value (`succeeded` or `failed`). When `succeeded`, the `output` field contains the humanized text; when `failed`, the `error` object describes what went wrong. Lookups are rate limited to 120 requests/minute per key. operationId: getHumanizeJob parameters: - name: id in: path required: true description: The job ID returned when the job was created. schema: type: string format: uuid example: 7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10 responses: '200': description: The job's current state. headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Job' examples: succeeded: summary: Completed job value: id: 7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10 status: succeeded mode: humanize input_words: 9 words_reserved: 9 words_charged: 9 status_url: >- https://www.wibbleai.com/api/v1/humanize/7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10 current_stage: completed detected_language: en created_at: '2026-06-14T12:00:00.000Z' completed_at: '2026-06-14T12:00:42.000Z' output: Mitochondria are the cell's powerhouses. failed: summary: Failed job (words refunded) value: id: 7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10 status: failed mode: humanize input_words: 9 words_reserved: 9 words_charged: 0 status_url: >- https://www.wibbleai.com/api/v1/humanize/7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10 current_stage: null detected_language: null created_at: '2026-06-14T12:00:00.000Z' completed_at: '2026-06-14T13:00:00.000Z' error: code: job_expired message: The job expired before completion. '401': $ref: '#/components/responses/Unauthorized' '404': description: No job with this ID exists for the authenticated account. headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: not_found message: Job not found. '429': description: The per-key lookup rate limit of 120 requests/minute was exceeded. headers: Retry-After: $ref: '#/components/headers/Retry-After' X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/RateLimitError' example: error: code: rate_limited message: Too many API requests. Retry after the reset time. retry_after_seconds: 30 reset_at: '2026-06-14T12:01:00.000Z' components: headers: X-RateLimit-Limit: description: The maximum number of requests allowed in the current window. schema: type: integer example: 20 X-RateLimit-Remaining: description: The number of requests remaining in the current window. schema: type: integer example: 19 X-RateLimit-Reset: description: ISO 8601 timestamp at which the current rate-limit window resets. schema: type: string format: date-time example: '2026-06-14T12:01:00.000Z' Retry-After: description: >- Number of seconds to wait before retrying. For `too_many_concurrent_jobs` this is the literal value `10`. schema: type: string example: '10' schemas: Job: type: object description: A humanization job. required: - id - status - mode - input_words - words_reserved - words_charged - status_url - current_stage - detected_language - created_at - completed_at properties: id: type: string format: uuid description: Unique job identifier. example: 7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10 status: type: string enum: - queued - running - succeeded - failed description: Current job status. Terminal states are `succeeded` and `failed`. mode: type: string description: The processing mode. Always `humanize` for this endpoint. example: humanize input_words: type: integer description: Number of words counted in the input text. example: 9 words_reserved: type: integer description: Number of API words reserved from the account balance for this job. example: 9 words_charged: type: integer description: >- Net words charged (`words_reserved` minus refunds, floored at 0). For a failed job this is `0` because reserved words are refunded. example: 9 status_url: type: string format: uri description: Absolute URL for polling this job. example: >- https://www.wibbleai.com/api/v1/humanize/7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10 current_stage: type: - string - 'null' description: The current pipeline stage, or null if unavailable. example: refining_draft detected_language: type: - string - 'null' description: The detected input language, or null if not yet detected. example: en created_at: type: string format: date-time description: ISO 8601 timestamp when the job was created. example: '2026-06-14T12:00:00.000Z' completed_at: type: - string - 'null' format: date-time description: ISO 8601 timestamp when the job completed, or null if not finished. example: null output: type: string description: >- The humanized text. Present only when `status` is `succeeded`; omitted otherwise. example: Mitochondria are the cell's powerhouses. error: $ref: '#/components/schemas/JobError' examples: - id: 7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10 status: queued mode: humanize input_words: 9 words_reserved: 9 words_charged: 9 status_url: >- https://www.wibbleai.com/api/v1/humanize/7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10 current_stage: detecting_language detected_language: null created_at: '2026-06-14T12:00:00.000Z' completed_at: null Error: type: object description: Standard error envelope. required: - error properties: error: type: object required: - code - message properties: code: type: string description: Machine-readable error code. example: validation_error message: type: string description: Human-readable error message. example: Text is required RateLimitError: allOf: - $ref: '#/components/schemas/Error' - type: object required: - retry_after_seconds - reset_at properties: retry_after_seconds: type: integer description: Seconds to wait before retrying. example: 12 reset_at: type: string format: date-time description: ISO 8601 timestamp when the rate-limit window resets. example: '2026-06-14T12:01:00.000Z' example: error: code: rate_limited message: Too many API requests. Retry after the reset time. retry_after_seconds: 12 reset_at: '2026-06-14T12:01:00.000Z' JobError: type: object description: Present only when the job `status` is `failed`; omitted otherwise. required: - code - message properties: code: type: string description: Machine-readable error code. Defaults to `processing_failed`. example: processing_failed message: type: string description: Human-readable error message. example: Humanization failed. Reserved words have been refunded. responses: Unauthorized: description: >- Authentication failed. The `Authorization` header was missing (`Missing API key.`) or the key was invalid, expired, revoked, or lacking the `humanize` scope (`Invalid API key.`). This response does not include rate-limit headers. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing: summary: No API key provided value: error: code: unauthorized message: Missing API key. invalid: summary: Key invalid, expired, revoked, or wrong scope value: error: code: unauthorized message: Invalid API key. securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key authentication. Pass your key as `Authorization: Bearer `. Keys look like `wib_live_...` and are created in the Wibble dashboard. A key must have the `humanize` scope to use these endpoints. ````