{"openapi":"3.0.1","info":{"title":"Platsbanken API","description":"Documentation for Platsbanken API used by Team Annonsera i Platsbanken","contact":{"name":"Annonsera i Platsbanken","email":"TeamAnnonseraPlatsbanken@arbetsformedlingen.se"},"version":"1.0.0"},"servers":[{"url":"http://platsbanken-api.apps.pocp4.arbetsformedlingen.se","description":"Generated server url"}],"paths":{"/jobs/v1/typeahead/suggestions":{"get":{"tags":["/jobs/v1/typeahead/suggestions"],"description":"Get typeahead suggestions","operationId":"fetchTypeaheadSuggestions","parameters":[{"name":"q","in":"query","required":true,"schema":{"maxLength":256,"minLength":0,"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/TypeaheadResult"}}}}}},"post":{"tags":["/jobs/v1/typeahead/suggestions"],"description":"Get typeahead suggestions, with occurrences","operationId":"fetchTypeaheadSuggestions_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Query"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/TypeaheadResults"}}}}}}},"/jobs/v1/search":{"post":{"tags":["/jobs/v1/search"],"operationId":"searchForJobAds","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Query"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/SearchResultResponse"}}}}}}},"/jobs/v1/query/transform":{"post":{"tags":["/jobs/v1/query/transform"],"operationId":"transform","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Query"}}},"required":true},"responses":{"200":{"description":"OK","content":{"text/plain;charset=UTF-8":{"schema":{"type":"string"}}}}}}},"/jobs/v1/job":{"post":{"tags":["/jobs/v1/job"],"operationId":"searchForJobAds_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdTeaser"}}}}}}}},"/jobs/v1/job/joblinks":{"post":{"tags":["/jobs/v1/job"],"operationId":"searchForJoblinksAds","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsJoblinksRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdTeaser"}}}}}}}},"/jobs/v1/applicationclick":{"post":{"tags":["/jobs/v1/click"],"operationId":"logApplicationData","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationClickRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"string"}}}}}}},"/v2/taxonomy/typeahead":{"get":{"tags":["/jobs/v1/typeahead/suggestions"],"operationId":"fetchTypeahead","parameters":[{"name":"input","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"maximum":50,"type":"integer","format":"int32","default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TypeaheadResponse"}}}}}}}},"/v2/taxonomy/trees":{"get":{"tags":["/taxonomy"],"operationId":"fetchTypeaheadValues","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string","enum":["OCCUPATION","LOCATION"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"uniqueItems":true,"type":"array","items":{"$ref":"#/components/schemas/Parent"}}}}}}}},"/v2/taxonomy/occupation/adjacent":{"get":{"tags":["/taxonomy"],"operationId":"fetchAdjacentOccupation","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaxonomyElementRecord"}}}}}}}},"/v2/taxonomy/municipality/commuting/{id}":{"get":{"tags":["/taxonomy"],"operationId":"fetchCommutingMunicipalities","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CommuterMunicipalityRecord"}}}}}}}},"/v2/taxonomy/concept":{"get":{"tags":["/taxonomy"],"operationId":"fetchTaxonomyConcept","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"type","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxonomyElement"}}}}}}},"/jobs/v1/token":{"get":{"tags":["/jobs/v1/token"],"operationId":"getToken","responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/TokenData"}}}}}}},"/jobs/v1/statistics":{"get":{"tags":["/jobs/v1/statistics"],"operationId":"fetchMostAvailableJobs","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OccupationStatistic"}}}}}}}},"/jobs/v1/search/amount":{"get":{"tags":["/jobs/v1/search"],"operationId":"fetchNumberAvailableJobs","responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"integer","format":"int32"}}}}}}},"/jobs/v1/job/{id}":{"get":{"tags":["/jobs/v1/job"],"operationId":"searchForJobAds_2","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/Ad"}}}}}}},"/jobs/v1/job/{id}/share":{"get":{"tags":["/jobs/v1/job"],"operationId":"fetchSharedInfo","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/AdToShare"}}}}}}},"/jobs/v1/job/joblinks/{id}":{"get":{"tags":["/jobs/v1/job"],"operationId":"searchForJoblinksJobAd","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/JoblinksAd"}}}}}}}},"components":{"schemas":{"Filter":{"type":"object","properties":{"type":{"type":"string"},"value":{"type":"string"}}},"Query":{"type":"object","properties":{"fromDate":{"type":"string","format":"date-time"},"toDate":{"type":"string","format":"date-time"},"maxRecords":{"type":"integer","format":"int32"},"order":{"type":"string"},"startIndex":{"type":"integer","format":"int32"},"source":{"type":"string"},"filters":{"type":"array","items":{"$ref":"#/components/schemas/Filter"}}}},"Typeahead":{"type":"object","properties":{"value":{"type":"string"},"occurrences":{"type":"integer","format":"int32"}}},"TypeaheadResults":{"type":"object","properties":{"result":{"type":"array","items":{"$ref":"#/components/schemas/Typeahead"}}}},"AdTeaser":{"type":"object","properties":{"id":{"type":"string"},"publishedDate":{"type":"string","format":"date-time"},"lastApplicationDate":{"type":"string","format":"date-time"},"title":{"type":"string"},"occupation":{"type":"string"},"workplace":{"type":"string"},"workplaceName":{"type":"string"},"unspecifiedWorkplace":{"type":"boolean"},"published":{"type":"boolean"},"positions":{"type":"integer","format":"int32"},"sourceLinks":{"type":"array","items":{"$ref":"#/components/schemas/SourceLink"}}}},"SearchResultResponse":{"type":"object","properties":{"positions":{"type":"integer","format":"int32"},"numberOfAds":{"type":"integer","format":"int32"},"offsetLimit":{"type":"integer","format":"int32"},"ads":{"type":"array","items":{"$ref":"#/components/schemas/AdTeaser"}}}},"SourceLink":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}}},"AdsRequest":{"required":["ids"],"type":"object","properties":{"ids":{"maxItems":50,"minItems":1,"type":"array","items":{"type":"integer","format":"int32"}}}},"AdsJoblinksRequest":{"required":["ids"],"type":"object","properties":{"ids":{"maxItems":50,"minItems":1,"type":"array","items":{"type":"string"}}}},"ApplicationClickRequest":{"type":"object","properties":{"device_id":{"type":"string"},"ansokningssatt":{"type":"string"},"annons_id":{"type":"string"},"tidpunkt":{"type":"integer","format":"int64"}}},"TypeaheadResponse":{"type":"object","properties":{"id":{"type":"string"},"preferredLabel":{"type":"string"},"type":{"type":"string"},"category":{"type":"string"}}},"Child":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"legacyAmsTaxonomyId":{"type":"string"},"parentId":{"type":"string"}}},"Parent":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"legacyAmsTaxonomyId":{"type":"string"},"items":{"uniqueItems":true,"type":"array","items":{"$ref":"#/components/schemas/Child"}}}},"TaxonomyElementRecord":{"type":"object","properties":{"id":{"type":"string"},"preferred_label":{"type":"string"}}},"CommuterMunicipalityRecord":{"type":"object","properties":{"id":{"type":"string"},"preferred_label":{"type":"string"},"commuters":{"type":"integer","format":"int32"}}},"TaxonomyElement":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"legacyAmsTaxonomyId":{"type":"string"}}},"TypeaheadResult":{"type":"object","properties":{"q":{"type":"string"},"result":{"type":"array","items":{"type":"string"}}}},"TokenData":{"type":"object","properties":{"accessToken":{"type":"string"},"subdomain":{"type":"string"}}},"OccupationStatistic":{"type":"object","properties":{"name":{"type":"string"},"occurrences":{"type":"integer","format":"int32"}}},"Ad":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"publishedDate":{"type":"string","format":"date-time"},"occupation":{"type":"string"},"company":{"$ref":"#/components/schemas/Company"},"logotype":{"type":"string"},"conditions":{"type":"string"},"salaryDescription":{"type":"string"},"salaryType":{"type":"string"},"workTimeExtent":{"type":"string"},"employmentType":{"type":"string"},"duration":{"type":"string"},"lastApplicationDate":{"type":"string","format":"date-time"},"expirationDate":{"type":"string","format":"date-time"},"positions":{"type":"integer","format":"int32"},"published":{"type":"boolean"},"ownCar":{"type":"boolean"},"requiresExperience":{"type":"boolean"},"education":{"$ref":"#/components/schemas/KnowledgeDetail"},"application":{"$ref":"#/components/schemas/Application"},"workplace":{"$ref":"#/components/schemas/Workplace"},"drivingLicense":{"type":"array","items":{"type":"string"}},"skills":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeDetail"}},"languages":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeDetail"}},"workExperiences":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeDetail"}},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/Contact"}},"keywords":{"type":"array","items":{"type":"string"}}}},"Application":{"type":"object","properties":{"mail":{"type":"string"},"email":{"type":"string"},"webAddress":{"type":"string"},"other":{"type":"string"},"reference":{"type":"string"},"information":{"type":"string"}}},"Company":{"type":"object","properties":{"name":{"type":"string"},"streetAddress":{"type":"string"},"postCode":{"type":"string"},"city":{"type":"string"},"phoneNumber":{"type":"string"},"webAddress":{"type":"string"},"email":{"type":"string"},"organisationNumber":{"type":"string"}}},"Contact":{"type":"object","properties":{"name":{"type":"string"},"surname":{"type":"string"},"position":{"type":"string"},"mobileNumber":{"type":"string"},"phoneNumber":{"type":"string"},"email":{"type":"string"},"union":{"type":"boolean"},"description":{"type":"string"}}},"KnowledgeDetail":{"type":"object","properties":{"name":{"type":"string"},"required":{"type":"boolean"},"level":{"$ref":"#/components/schemas/Level"}}},"Level":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"Workplace":{"type":"object","properties":{"name":{"type":"string"},"street":{"type":"string"},"postCode":{"type":"string"},"city":{"type":"string"},"unspecifiedWorkplace":{"type":"boolean"},"region":{"type":"string"},"country":{"type":"string"},"municipality":{"type":"string"},"longitude":{"type":"string"},"latitude":{"type":"string"},"showMap":{"type":"boolean"}}},"AdToShare":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"logotype":{"type":"string"},"logotypFixed":{"type":"string"},"lastApplicationDate":{"type":"string","format":"date-time"}}},"JoblinksAd":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"publishedDate":{"type":"string","format":"date-time"},"occupation":{"type":"string"},"company":{"$ref":"#/components/schemas/Company"},"workplaces":{"type":"array","items":{"$ref":"#/components/schemas/Workplace"}},"sourceLinks":{"type":"array","items":{"$ref":"#/components/schemas/SourceLink"}}}}}}}