api
Work visa text: what the advert says
work_visa_text quotes what the employer's own advert says about visa sponsorship, work permits, relocation and the right to work, and sorts it into four evidence levels by a fixed rule.
1What the field says
Every job carries work_visa_text: the employer's own statements about visas and permits, each with a quote copied word for word from the advert, and an evidence_level.
In depthWhy it exists, what it is not, what people get wrong
The field describes the advert. It is not advice and not a decision on any person's case, and it says nothing about whether a visa or permit is granted: that depends on the person, the employer and the authority, which an advert does not show. The same reading is shown to every reader.
The quotes are the employer's words. The codes are JOA's reading of them: a language model finds and codes the statements, and code checks that every quote is found exactly in the advert before it is stored. A reading is shown only while the title and the text are exactly the ones that were read (a hash of that text, compared byte for byte; a change of any other field of the job does not count). Adverts longer than 8,000 characters are read as their first 5,000 and last 3,000 characters.
{
"work_visa_text": {
"evidence_level": "stated_closed",
"statements": [
{
"code": "text_permit_required",
"quote": "Eine gültige Arbeitserlaubnis für Deutschland ist Voraussetzung.",
"quote_lang": "de",
"method": "published_by_employer"
}
],
"method_version": "eu-signals-v1",
"as_of": "2026-11-14",
"legal_note_code": "immigration_information"
}
}2The evidence levels
Four values, by a fixed rule over the codes: a closing statement wins over every other statement.
In depthWhy it exists, what it is not, what people get wrong
stated_closed- At least one statement is text_no_sponsorship, text_permit_required or text_citizenship_restriction. This wins over every other statement of the same advert, an offer of help included.
stated_open- A statement is text_permit_support, and no statement closes the job.
no_information- JOA read the advert and found no statement of these kinds, or only text_relocation_support. The advert is silent; that is not a refusal. Most adverts say nothing of this kind, also at employers that hire from abroad.
not_assessed- No current reading: the job was not read yet (only the countries under Coverage are read), or its title or text changed since it was read (JOA compares a hash of the exact text that was read, byte for byte; a change of any other field does not count), or a quote cannot be shown exactly as the employer wrote it, or the field is switched off.
3The statement codes
Five codes. Each statement carries one, with the quote it was read from.
In depthWhy it exists, what it is not, what people get wrong
text_permit_support- The advert says the employer helps with or pays for a visa, a work or residence permit, an EU Blue Card or the immigration process for this job.
text_relocation_support- The advert offers help to relocate: a relocation package, moving costs, help to find housing, or a relocation bonus or service. On its own it says nothing about permits.
text_permit_required- The advert asks for an existing right to work in the country (a valid work or residence permit, a named permit type, settled status), or says the employer does not help candidates who need one.
text_no_sponsorship- The advert says the employer does not or cannot sponsor visas or work permits.
text_citizenship_restriction- The advert limits the job to citizens or nationals of a country, or of the EU or EEA, or asks for a security clearance that needs citizenship.
4The quotes are verbatim
A quote is copied character for character from the advert title or description, in the advert's own language. It is never translated, shortened or corrected.
In depthWhy it exists, what it is not, what people get wrong
quote: the employer's words, as the advert shows them on this job.quote_lang: the ISO 639-1 code of the language JOA detected for the advert text (the job'slanguage), null when it was not detected.method: alwayspublished_by_employer: the statement is in the employer's own advert.- A statement is shown only with its quote. When a quote cannot be shown exactly as the employer wrote it (for example because it contains contact details, which JOA removes from advert text), the whole field reads
not_assessed. A quote is never edited. method_versionnames the reading method (for exampleeu-signals-v1) andas_ofthe day the advert was read.
5Coverage
Read so far: jobs in Germany (DE), France (FR) and Italy (IT) that were live when they were read, up to 2026-11-14. Every other job reads not_assessed.
In depthWhy it exists, what it is not, what people get wrong
A job first seen after it was read, or changed since, reads not_assessed until it is read again. /v1/help lists the same coverage under work_visa_text.coverage.
6Filtering on it
visa_text=stated_open or visa_text=stated_closed keeps only the jobs with that evidence level. Jobs not read never match.
In depthWhy it exists, what it is not, what people get wrong
The filter works on /v1/jobs, /v1/jobs/similar, /v1/jobs/closed and /v1/export, and combines with every other filter. Any other value is a 422 bad_visa_text and nothing is charged. Metering is unchanged.
curl -H "Authorization: Bearer $JOA_KEY" \
"https://api.jobopportunitiesapi.org/v1/jobs?country=DE&visa_text=stated_open&limit=20"7The legal note
A job whose work_visa_text carries a statement carries the legal note immigration_information. Show it with the field.
In depthWhy it exists, what it is not, what people get wrong
It is the same note as for sponsor_registers and visa_checks (legal_note_code, legal_note). A field without a statement carries no note.
This page was rendered 17 November 2026, 07:47 UTC. Every figure on it comes from the endpoint named beside it, and every published request is re-sent against the live API before this site is allowed to build. If something here is wrong, the thumbs-down above reaches a person.