Skip to main content
GET
Retrieve a humanization job

Authorizations

​
Authorization
string
header
required

API key authentication. Pass your key as Authorization: Bearer <key>. Keys look like wib_live_... and are created in the Wibble dashboard. A key must have the humanize scope to use these endpoints.

Path Parameters

​
id
string<uuid>
required

The job ID returned when the job was created.

Response

The job's current state.

A humanization job.

​
id
string<uuid>
required

Unique job identifier.

Example:

"7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10"

​
status
enum<string>
required

Current job status. Terminal states are succeeded and failed.

Available options:
queued,
running,
succeeded,
failed
​
mode
string
required

The processing mode. Always humanize for this endpoint.

Example:

"humanize"

​
input_words
integer
required

Number of words counted in the input text.

Example:

9

​
words_reserved
integer
required

Number of API words reserved from the account balance for this job.

Example:

9

​
words_charged
integer
required

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
string<uri>
required

Absolute URL for polling this job.

Example:

"https://www.wibbleai.com/api/v1/humanize/7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10"

​
current_stage
string | null
required

The current pipeline stage, or null if unavailable.

Example:

"refining_draft"

​
detected_language
string | null
required

The detected input language, or null if not yet detected.

Example:

"en"

​
created_at
string<date-time>
required

ISO 8601 timestamp when the job was created.

Example:

"2026-06-14T12:00:00.000Z"

​
completed_at
string<date-time> | null
required

ISO 8601 timestamp when the job completed, or null if not finished.

Example:

null

​
output
string

The humanized text. Present only when status is succeeded; omitted otherwise.

Example:

"Mitochondria are the cell's powerhouses."

​
error
object

Present only when the job status is failed; omitted otherwise.