{"openapi":"3.0.1","info":{"title":"TMT - Työpaikkailmoitusten hakupalvelu | Job posting provider service","description":"FI: Hae kaikki Työmarkkinatorilla julkaistut ja arkistoidut työpaikkailmoitukset\nEN: Retrieve all published and archived Job postings in Job market Finland\n","version":"v1"},"servers":[{"url":"https://tyomarkkinatori.fi","description":"Generated server url"}],"security":[{"bearerAuth":[]}],"paths":{"/v2/jobpostings":{"post":{"tags":["jobpostings"],"description":"FI: Hae julkaistut työpaikkailmoitukset\nEN: Get published Job postings\n","operationId":"getJobPostings","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiltersV2"}}},"required":true},"responses":{"200":{"description":"OK","headers":{"RateLimit-Remaining":{"style":"simple","schema":{"maxLength":5}},"RateLimit-Reset":{"style":"simple","schema":{"maxLength":5}},"Access-Control-Allow-Origin":{"style":"simple","schema":{"maxLength":5000}},"RateLimit-Limit":{"style":"simple","schema":{"maxLength":5}}},"content":{"application/x-ndjson":{"schema":{"maxItems":2147483647,"type":"array","items":{"$ref":"#/components/schemas/JobPostingV2"}}}}}}}}},"components":{"schemas":{"Application":{"type":"object","properties":{"published":{"maxLength":26,"type":"string","description":"FI: Ilmoituksen julkaisupäivä. Voi puuttua tai null ilmoituksille jotka halutaan julkaista heti tai tulevaisuudessa (max 90 päivää) ajatetuille julkaisuille.\nEN: Publish date. Can be null or absent for postings meant to be published immediately or in the future (max 90 days) for timed publishing.\n","format":"date-time"},"expires":{"maxLength":26,"type":"string","description":"FI: Ilmoituksen voimassaolo\nEN: Expiration date of application\n","format":"date-time"},"openPositions":{"maximum":1000,"minimum":1,"type":"integer","description":"FI: Avointen paikkojen määrä\nEN: Number of open positions\n","format":"int32"},"helpText":{"maxLength":3,"type":"object","additionalProperties":false,"description":"FI: Ohjeet työpaikan hakemiseen\nEN: Instructions for application\n"},"url":{"maxLength":3,"type":"object","additionalProperties":false,"description":"FI: Hakemuksen www-osoite\nEN: Web address of the application\n"}}},"Client":{"type":"object","properties":{"businessId":{"maxLength":50,"type":"string","description":"FI: Toimeksiantavan yrityksen tunnus\nEN: Principal business id\n"},"company":{"maxLength":254,"type":"string","description":"FI: Toimeksiantavan yrityksen nimi\nEN: Principal company name\n"},"industryCode":{"maxLength":6,"type":"string","description":"FI: Toimialakoodi\nEN: Industry code\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TOIMIALA/koodit"}},"officeCode":{"maxLength":20,"pattern":"(\\d{7}-\\d-(\\d{1,10}|X))|([A-Z]{2}\\d{9}-\\d{1,10})|(9999)","type":"string","description":"FI: Toimeksiantavan yrityksen toimipaikan tunnus\nEN: Office code of principal company\n"},"officeName":{"maxLength":1024,"type":"string","description":"FI: Toimeksiantavan yrityksen toimipaikan nimi\nEN: Office name of principal company\n"}}},"Contact":{"type":"object","properties":{"firstName":{"maxLength":100,"type":"string","description":"FI: Etunimi\nEN: First name\n"},"lastName":{"maxLength":100,"type":"string","description":"FI: Sukunimi\nEN: Last name\n"},"email":{"maxLength":254,"type":"string","description":"FI: Sähköpostiosoite\nEN: Email address\n"},"telephone":{"maxLength":50,"type":"string","description":"FI: Puhelinnumero\nEN: Phone number\n"}},"description":"FI: Yhteystiedot\nEN: Contact infos\n"},"ExternalLink":{"type":"object","properties":{"url":{"maxLength":300,"type":"string","description":"FI: WWW-osoite\nEN: External url\n"},"description":{"maxLength":50,"type":"string","description":"FI: Kuvaus\nEN: Description\n"}},"description":"FI: Ulkoiset linkit\nEN: External links\n"},"JobPostingV2":{"required":["languages"],"type":"object","properties":{"languages":{"maxItems":3,"minItems":0,"type":"array","items":{"maxLength":2,"minLength":0,"type":"string"}},"descriptionsContentType":{"maxLength":10,"type":"string","description":"FI: Kuvauskenttien sisältötyyppi (plain/markdown)\nEN: Content type of description fields (plain/markdown)\n"},"metadata":{"$ref":"#/components/schemas/Metadata"},"client":{"$ref":"#/components/schemas/Client"},"position":{"$ref":"#/components/schemas/Position"},"owner":{"$ref":"#/components/schemas/Owner"},"location":{"$ref":"#/components/schemas/Location"},"application":{"$ref":"#/components/schemas/Application"},"externalLinks":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Ulkoiset linkit\nEN: External links\n","items":{"$ref":"#/components/schemas/ExternalLink"}},"contacts":{"maxItems":20,"minItems":0,"type":"array","description":"FI: Yhteystiedot\nEN: Contact infos\n","items":{"$ref":"#/components/schemas/Contact"}}}},"Location":{"type":"object","properties":{"countries":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Maat\nEN: Countries\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/MAA/koodit"},"items":{"maxLength":2,"minLength":0,"type":"string","description":"FI: Maat\nEN: Countries\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/MAA/koodit"}}},"regions":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Maakunnat\nEN: Regions\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/MAAKUNTA/koodit"},"items":{"maxLength":2,"minLength":0,"type":"string","description":"FI: Maakunnat\nEN: Regions\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/MAAKUNTA/koodit"}}},"municipalities":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Kunnat\nEN: Municipalities\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/KUNTA/koodit"},"items":{"maxLength":3,"minLength":0,"type":"string","description":"FI: Kunnat\nEN: Municipalities\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/KUNTA/koodit"}}},"requiresTravelling":{"type":"boolean","description":"FI: Työhön kuuluu matkustamista\nEN: Work requires travelling\n"},"workplaceAddress":{"maxLength":50,"type":"string","description":"FI: Katuosoite\nEN: Street address\n"},"workplacePostalCode":{"maxLength":20,"pattern":"(^[A-Za-z0-9 -]{3,10}$)","type":"string","description":"FI: Postinumero\nEN: Postal code\n"},"workplacePostOffice":{"maxLength":50,"type":"string","description":"FI: Postitoimipaikka\nEN: Post office\n"},"workplaceName":{"maxLength":3,"type":"object","additionalProperties":false,"description":"FI: Toimipaikan tai työskentelypaikan nimi\nEN: Name of the workplace\n"}}},"Metadata":{"type":"object","properties":{"externalId":{"maxLength":36,"type":"string","description":"FI: Ulkoinen tunniste\nEN: External id\n","format":"uuid"},"created":{"maxLength":26,"type":"string","description":"FI: Luotu\nEN: Created\n","format":"date-time"},"lastModified":{"maxLength":26,"type":"string","description":"FI: Viimeksi muokattu\nEN: Last modified\n","format":"date-time"},"archived":{"maxLength":26,"type":"string","description":"FI: Arkistoitu\nEN: Archived\n","format":"date-time"}}},"Owner":{"type":"object","properties":{"employerType":{"maxLength":22,"type":"string","description":"FI: Ilmoituksen omistavan organisaation tyyppi\nEN: Employer type of owner organization\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TYOPAIKKAILMOITUS_ILMOITTAJAN_TYYPPI/koodit"}},"businessId":{"maxLength":50,"type":"string","description":"FI: Ilmoituksen omistavan organisaation y-tunnus\nEN: Business id of owner organization\n"},"industryCode":{"maxLength":6,"type":"string","description":"FI: Ilmoituksen omistavan organisaation toimialakoodi\nEN: Industry code of owner organization\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TOIMIALA/koodit"}},"officeCode":{"maxLength":20,"type":"string","description":"FI: Ilmoituksen omistavan organisaation toimipaikkatiedon koodi\nEN: Office code of owner organization\n"},"officeName":{"maxLength":1024,"type":"string","description":"FI: Ilmoituksen omistavan organisaation toimipaikan nimi\nEN: Office name of owner organization\n"},"company":{"maxLength":3,"type":"object","additionalProperties":false,"description":"FI: Ilmoituksen omistavan organisaation nimi\nEN: Company name of owner organization\n"},"reference":{"maxLength":64,"type":"string","description":"FI: Ilmoittajan oma viitetieto\nEN: Extra reference information of owner organization\n"},"householdEmployer":{"maxLength":100,"type":"string","description":"FI: Kotitaloustyönantajan nimi\nEN: Household employer name\n"}}},"Position":{"type":"object","properties":{"employmentRelationship":{"maxLength":4,"type":"string","description":"FI: Palvelussuhde\nEN: Employment relationship\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/PALVELUSSUHDE/koodit"}},"continuityOfWork":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Työn jatkuvuus\nEN: Continuity of work\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TY%C3%96N_JATKUVUUS/koodit"},"items":{"maxLength":4,"minLength":0,"type":"string","description":"FI: Työn jatkuvuus\nEN: Continuity of work\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TY%C3%96N_JATKUVUUS/koodit"}}},"durationOfTemporary":{"maxLength":2,"type":"string","description":"FI: Määräaikaisuuden kesto\nEN: Duration of temporary work\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/M%C3%84%C3%84R%C3%84AIKAISUUDEN_KESTO/koodit"}},"wagePrincipal":{"maxLength":40,"type":"string","description":"FI: Palkan peruste\nEN: Wage principal\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/PALKAN_PERUSTE/koodit"}},"wageRange":{"maxLength":8,"type":"string","description":"FI: Palkkahaitari\nEN: Wage spread\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/PALKKAHAITARI/koodit"}},"workLanguages":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Työkielet\nEN: Work languages\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/KIELI/koodit"},"items":{"maxLength":3,"minLength":0,"type":"string","description":"FI: Työkielet\nEN: Work languages\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/KIELI/koodit"}}},"workTime":{"maxLength":4,"type":"string","description":"FI: Työaika\nEN: Work time\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TY%C3%96AIKA/koodit"}},"workTimeDetails":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Työskentelyaika\nEN: Work time details\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TY%C3%96SKENTELYAIKA/koodit"},"items":{"maxLength":4,"minLength":0,"type":"string","description":"FI: Työskentelyaika\nEN: Work time details\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TY%C3%96SKENTELYAIKA/koodit"}}},"criminalRecordVerification":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Rikosrekisteriotteet\nEN: Criminal record extracts\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TYOPAIKKAILMOITUS_RIKOSREKISTERIOTE/koodit"},"items":{"maxLength":2,"minLength":0,"type":"string","description":"FI: Rikosrekisteriotteet\nEN: Criminal record extracts\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TYOPAIKKAILMOITUS_RIKOSREKISTERIOTE/koodit"}}},"drivingLicenses":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Ajokortit\nEN: Driving licenses\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/AJOKORTTILUOKKA/koodit"},"items":{"maxLength":5,"minLength":0,"type":"string","description":"FI: Ajokortit\nEN: Driving licenses\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/AJOKORTTILUOKKA/koodit"}}},"permitCards":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Luvat ja kortit\nEN: Permit cards\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TY%C3%96NHAKUPROFIILI_LUPA_KORTTI/koodit"},"items":{"maxLength":3,"minLength":0,"type":"string","description":"FI: Luvat ja kortit\nEN: Permit cards\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TY%C3%96NHAKUPROFIILI_LUPA_KORTTI/koodit"}}},"mainOccupation":{"maxLength":254,"type":"string","description":"FI: Työpaikkailmoituksen pääasiallinen ammatti\nEN: Main occupation of job posting\n","externalDocs":{"url":"https://esco.ec.europa.eu/fi/classification/occupation_main"}},"occupations":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Esco ammatit\nEN: Esco occupations\n","externalDocs":{"url":"https://esco.ec.europa.eu/fi/classification/occupation_main"},"items":{"maxLength":100,"minLength":0,"type":"string","description":"FI: Esco ammatit\nEN: Esco occupations\n","externalDocs":{"url":"https://esco.ec.europa.eu/fi/classification/occupation_main"}}},"skills":{"maxItems":10,"minItems":0,"type":"array","description":"FI: Esco osaamiset\nEN: Esco skills\n","externalDocs":{"url":"https://esco.ec.europa.eu/fi/classification/skill_main"},"items":{"maxLength":100,"minLength":0,"type":"string","description":"FI: Esco osaamiset\nEN: Esco skills\n","externalDocs":{"url":"https://esco.ec.europa.eu/fi/classification/skill_main"}}},"title":{"maxLength":3,"type":"object","additionalProperties":false,"description":"FI: Haettavaa työtä kuvaava otsikko\nEN: Title of work application\n"},"jobDescription":{"maxLength":3,"type":"object","additionalProperties":false,"description":"FI: Työn kuvaus\nEN: Job description\n"},"wagePrincipalInfo":{"maxLength":3,"type":"object","additionalProperties":false,"description":"FI: Palkan peruste - Lisätietoja\nEN:\n"},"partTimeInfo":{"maxLength":3,"type":"object","additionalProperties":false,"description":"FI: Osa-aikaisuuden tiedot\nEN:\n"},"marketingDescription":{"maxLength":3,"type":"object","additionalProperties":false,"description":"FI: Työnantajayrityksen markkinointikuvaus\nEN: Marketing descriptions of employer\n"},"permitCardsDescription":{"maxLength":3,"type":"object","additionalProperties":false,"description":"FI: Lupien ja korttien kuvaukset\nEN: Permit cards descriptions\n"}}},"FiltersV2":{"type":"object","properties":{"onlyStatus":{"maxLength":20,"type":"string","description":"FI: Julkaisutilan suodatus\nEN: Status filter\n","enum":["PUBLISHED","ARCHIVED"]},"created":{"$ref":"#/components/schemas/Interval"},"modified":{"$ref":"#/components/schemas/Interval"},"published":{"$ref":"#/components/schemas/Interval"},"archived":{"$ref":"#/components/schemas/Interval"},"expires":{"$ref":"#/components/schemas/Interval"},"employerTypeIn":{"maxItems":10,"minItems":0,"uniqueItems":true,"type":"array","description":"FI: Ilmoittajan tyyppi, TYOPAIKKAILMOITUS_ILMOITTAJAN_TYYPPI koodisto\nEN: Employer type, code set TYOPAIKKAILMOITUS_ILMOITTAJAN_TYYPPI\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TYOPAIKKAILMOITUS_ILMOITTAJAN_TYYPPI/koodit"},"items":{"maxLength":10,"minLength":0,"type":"string","description":"FI: Ilmoittajan tyyppi, TYOPAIKKAILMOITUS_ILMOITTAJAN_TYYPPI koodisto\nEN: Employer type, code set TYOPAIKKAILMOITUS_ILMOITTAJAN_TYYPPI\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TYOPAIKKAILMOITUS_ILMOITTAJAN_TYYPPI/koodit"}}},"workTimeIn":{"maxItems":10,"minItems":0,"uniqueItems":true,"type":"array","description":"FI: Työaika, TYÖAIKA koodisto\nEN: Work time, code set TYÖAIKA\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TY%C3%96AIKA/koodit"},"items":{"maxLength":10,"minLength":0,"type":"string","description":"FI: Työaika, TYÖAIKA koodisto\nEN: Work time, code set TYÖAIKA\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TY%C3%96AIKA/koodit"}}},"continuityOfWorkIn":{"maxItems":10,"minItems":0,"uniqueItems":true,"type":"array","description":"FI: Työn jatkuvuus, TYÖN_JATKUVUUS koodisto\nEN: Continuity of work, code set TYÖN_JATKUVUUS\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TY%C3%96N_JATKUVUUS/koodit"},"items":{"maxLength":10,"minLength":0,"type":"string","description":"FI: Työn jatkuvuus, TYÖN_JATKUVUUS koodisto\nEN: Continuity of work, code set TYÖN_JATKUVUUS\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/TY%C3%96N_JATKUVUUS/koodit"}}},"postingLanguageIn":{"maxItems":3,"minItems":0,"uniqueItems":true,"type":"array","description":"FI: Kielet joilla ilmoitus on luotu (fi, sv, en)\nEN: Languages the posting is published in (fi, sv, en)\n","items":{"maxLength":2,"minLength":0,"type":"string","description":"FI: Kielet joilla ilmoitus on luotu (fi, sv, en)\nEN: Languages the posting is published in (fi, sv, en)\n"}},"countryIn":{"maxItems":10,"minItems":0,"uniqueItems":true,"type":"array","description":"FI: Maat\nEN: Countries\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/MAA/koodit"},"items":{"maxLength":2,"minLength":0,"type":"string","description":"FI: Maat\nEN: Countries\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/MAA/koodit"}}},"regionIn":{"maxItems":10,"minItems":0,"uniqueItems":true,"type":"array","description":"FI: Maakunnat\nEN: Regions\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/MAAKUNTA/koodit"},"items":{"maxLength":2,"minLength":0,"type":"string","description":"FI: Maakunnat\nEN: Regions\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/MAAKUNTA/koodit"}}},"municipalityIn":{"maxItems":10,"minItems":0,"uniqueItems":true,"type":"array","description":"FI: Kunnat\nEN: Municipalities\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/KUNTA/koodit"},"items":{"maxLength":3,"minLength":0,"type":"string","description":"FI: Kunnat\nEN: Municipalities\n","externalDocs":{"url":"https://tyomarkkinatori.fi/api/codes/v1/kopa/KUNTA/koodit"}}},"occupationIscoIn":{"maxItems":10,"minItems":0,"uniqueItems":true,"type":"array","description":"FI: Ammatin isco koodit (esim. 2211.1)\nEN: Isco code of occupation (e.g. 2211.1)\n","items":{"maxLength":4,"minLength":0,"type":"string","description":"FI: Ammatin isco koodit (esim. 2211.1)\nEN: Isco code of occupation (e.g. 2211.1)\n"}}},"description":"FI: Suodatusehdot kyselylle. Kaikki kentät optionaalisia.\nEN: Filters for request. All fields are optional (nullable).\n"},"Interval":{"type":"object","properties":{"from":{"maxLength":26,"type":"string","description":"FI: Aikaleimasuodatuksen alkuhetki (inclusive, voi puuttua/olla null)\nEN: Timestamp filter start time (inclusive, nullable)\n","format":"date-time"},"to":{"maxLength":26,"type":"string","description":"FI: Aikaleimasuodatuksen loppuhetki (exclusive, voi puuttua/olla null)\nEN: Timestamp filter end time (exclusive, nullable)\n","format":"date-time"}},"description":"FI: Ilmoituksen voimassaolohetki\nEN: Expiration date of the posting\n"}},"securitySchemes":{"bearerAuth":{"type":"http","description":"supports RFC8725","scheme":"bearer","bearerFormat":"JWT"}}}}