Skip to main content
POST
cURL

Authorizations

X-Api-Key
string
header
required

Your Jobo API key. Create one in the dashboard under Developers → API Keys. Live keys start with jbe_live_ and sandbox keys with jbe_test_.

Path Parameters

id
string<uuid>
required

Mailbox ID.

Body

application/json
application_id
string<uuid>
required

The application whose verification email should be found. Its apply host and provider give the extraction its context.

wait_seconds
integer | null
default:45

How long to keep polling before returning status: timeout. Values outside 5–75 are clamped to that range.

Required range: 5 <= x <= 75
type
enum<string> | null
default:any

What the verification email must carry:

  • code: a one-time code.
  • link: a confirmation link, which Jobo clicks server-side.
  • confirmation: a positive post-submit acknowledgment. No link is visited.
  • any (default): a code or a link, not a bare acknowledgment.
Available options:
code,
link,
confirmation,
any

Response

The poll finished: status found with the code, link or confirmation, or status timeout.

api_version
enum<string>
required

Version of the Auto Apply API contract.

Available options:
2026-08-31
Example:

"2026-08-31"

status
enum<string>
required

A timeout means no matching verification email arrived within wait_seconds. It is an expected outcome, not an error.

Available options:
found,
timeout
waited_seconds
integer
required
type
enum<string> | null

What email evidence was found. Only present when status is found.

Available options:
code,
link,
confirmation
code
string | null

The verification code. Only present when type is code.

The confirmation link found in the email. Only present when type is link.

Whether Jobo successfully clicked the confirmation link server-side. When false, click the returned link yourself.

Final HTTP status of the server-side click, when one was made.

email_from
string | null
email_subject
string | null
email_received_at
string<date-time> | null
diagnostics
object | null

What the poll actually observed. Present on every response so a timeout can be told apart: nothing arrived, something arrived that was not the evidence, or the extraction model was unavailable.