Skip to main content
GET
/
humanize
/
{id}
Retrieve a humanization job
curl --request GET \
  --url https://wibble.ai/api/v1/humanize/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "7b42f1d6-0a8c-4e8f-9a21-c6d9f47c2b10",
  "status": "succeeded",
  "mode": "humanize",
  "input_words": 9,
  "words_reserved": 9,
  "words_charged": 9,
  "status_url": "https://wibble.ai/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."
}

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://wibble.ai/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.