Every failed request to the wcb/v1 REST API returns the same body: a code, a translated message and data.status (the HTTP status).
{
"code": "wcb_already_applied",
"message": "You have already applied to this job.",
"data": { "status": 409 }
}
Branch on code and data.status, never on message: messages are translated and can change. Some errors add fields to data; those are listed in the table. The REST validation layer can also answer with WordPress’s own rest_invalid_param and rest_forbidden.
The job, company, candidate or application does not exist, or the caller may not see it. A private candidate profile answers this too
wcb_job_not_found
404
The moderation routes were given a job that does not exist
wcb_missing_title
400
POST /jobs without a title, or PATCH /jobs/{id} with an empty one. Also the block editor’s answer when a job, company, resume or board is published untitled
wcb_missing_name
400
PATCH /employers/{id} with an empty company name
wcb_salary_range
400
The minimum salary is above the maximum, after the request. A PATCH of one side is checked against the saved other side
wcb_active_job_limit
403
The employer is at the cap set with wcb_employer_active_job_limit. data.limit and data.count carry the numbers
wcb_insufficient_credits
402
The board charges credits and the balance is too low (Pro). data carries cost, balance and purchase_url
wcb_awaiting_payment
402
A moderator approved a job whose employer cannot pay yet; the job stays pending
wcb_job_not_live
409
Only a published job can be closed
wcb_pro_required
403
Resume import was started without Pro
wcb_source_inactive
400
The WP Job Manager plugin the import reads from is not active
The guest’s email belongs to an account; send them to sign in
wcb_guest_name_required
400
A guest application without a name
wcb_guest_email_invalid
400
A guest application without a valid email
wcb_required_fields
400
A required custom field was left empty on an application, a job create, or an update of a job, company, candidate or resume that sends custom_fields. Values already saved count. The message names the fields and data.fields lists their keys
wcb_resume_required
400
The site requires a resume and none came with the request
wcb_resume_no_pdf
400
The chosen built resume could not be turned into a PDF to attach (Pro)
wcb_invalid_resume
400
The resume or attachment id does not belong to the applicant
wcb_invalid_file_type
400
The upload is not a PDF, DOC or DOCX
wcb_file_too_large
400
The upload is over Application Resume File Size (MB)
wcb_no_file
400
An upload route got no file
wcb_apply_busy
409
The same application is still being saved; a double click lands here
wcb_invalid_status
400
A status outside the allowed list
wcb_application_closed
409
The application already has an outcome (withdrawn, position closed or job removed), so its status is final
wcb_withdraw_disabled
403
Allow Withdraw is off
wcb_withdraw_closed
409
The application already has an outcome and can no longer be withdrawn
wcb_note_empty
400
A hiring note with no text
wcb_note_not_found
404
The note was already removed, or belongs to someone else
The Settings > Integrations tab installs other Wbcom plugins. Its failures come back to that screen as a message, not as a REST status. The codes are wcb_cap (the user may not install plugins), wcb_fs (WordPress has no file access), wcb_unknown_companion, wcb_no_item, wcb_no_license, wcb_license_invalid, wcb_license_activation_failed, wcb_store_unreachable, wcb_no_package, wcb_download_rejected, wcb_install_failed and wcb_activate.