Job Offers

List all jobs with pagination and searching

Returns a paged list of jobs and provides search functionality.

get
https://api.migros.ch/migros/human-resources/v8/jobs

Query Parameters

searchstring

Simple search string which is fault-tolerant for user-entered text.

limitinteger

Maximum number of results (max 2000).

Default:10

>= 0<= 2000

offsetinteger

Result set offset.

Default:0

>= 0

sortstring

The sorting criteria.

Allowed values:scoredate_fromdate_totitlecompanylocation

Default:score

orderstring

The ordering direction.

Allowed values:ascdesc

Default:asc

viewstring

Show specific types of jobs, where ‘browse’ is hiding internal jobs and ‘internal’ only shows the internal ones. If a job has both internal and external channels, it only shows up in browse but not in internal. ‘all’ shows all jobs regardless of channels.

Allowed values:allbrowseinternal

Default:browse

langstring

Defines the language (de/fr/it/en) for this request as query parameter. Either use the query param “lang” or header “Accept-Language”, not both.

Allowed values:defriten

Default:de

Headers

Accept-Languagestring

Defines the language (de/fr/it/en) for this request as request header. Either use the query param “lang” or header “Accept-Language”, not both.

Allowed values:defriten

Default:de

Response

200 application/json

Returned when successful

JobCollection

A collection of job instances.

idsarray[string]

Ids only.

Is filled instead of the usual property for content, with only the ids when a call is made with verbosity=id on a
route that supports it.

total_hitsinteger | nullrequired

The total hits may exceed the actual count of results in the collection.

It represents the total number of results of a search and not only the
potentially paginated subset.

jobsarray[object]required

Job advertisements from the karriere portal.

Show Child Parameters
get/migros/human-resources/v8/jobs
 
200 application/json

Get a single job

Get information about a single job by ID.

get
https://api.migros.ch/migros/human-resources/v8/jobs/{id}

Query Parameters

langstring

Defines the language (de/fr/it/en) for this request as query parameter. Either use the query param “lang” or header “Accept-Language”, not both.

Allowed values:defriten

Default:de

Path Parameters

idstringrequired

Resource ID or slug (if available).

Headers

Accept-Languagestring

Defines the language (de/fr/it/en) for this request as request header. Either use the query param “lang” or header “Accept-Language”, not both.

Allowed values:defriten

Default:de

Response

200 application/json

Returned when successful

Job

Job advertisements from the karriere portal.

application_emailstring | null

Job application email address.

application_linkstring | null

Job application page weblink.

application_methodstring | null

Method how to apply for this job.

Values can be

  • “form” => use the application_link property to link to the application form.
  • “email” => use the application_link property to link to the application form.
ats_job_idinteger | null

ID of the job at source systems.

Not guaranteed to exist, not guaranteed to be unique.

benefitsarray | null[string]

Benefits that come with this job.

E.g. Barrierefreiheit, Aufenthaltsraum, “Pensionskasse: Leistungsprimat und Leistungsverdoppelung durch die Migros”

categorystring | null

??

E.g. administration, marketing, IT, …

channelsarray | null[object]

List of channels this job is published to

Show Child Parameters
companystring | null

Name of the migros company offering this job.

date_fromstring | null(date-time)

Job advertisement publication start date.

date_tostring | null(date-time)

Job advertisement publication end date.

degreestring | null

Highest required degree to apply for this job.

E.g. “Abgeschlossene Berufslehre (EFZ)”

This goes together with the field education.

educationstring | null

Field of expertise the applicants should have.

This goes together with the field degree.

education_typestring | null

What type of diploma you get with this apprenticeship.

Only for apprenticeships.

E.g. “Eidgenössisches Fähigkeitszeugnis”, “Eidgenössisches Berufsattest” or “Praktikum”

educationsarray | null[string]

Which education titles you get on this apprenticeship.

Only for apprenticeships.

Do not confuse with “education” which is the required education.

employment_durationstring | null

How long the job offers to keep the employee, either “unlimited” or “temporary”.

employment_typestring | null

Employment contract type for this job.

E.g. “Auf Stundenbasis”

expectationsarray | null[string]

Order list of expectations descriptions what the applicant will do on this job.

idstringrequired

ID of the job in the karriere portal.

introductionstring | null

Pitch to explain the job.

Newline characters need to be rendered as line breaks.

job_startstring | null

Type of when the job starts: “immediately”, “arranged” or “date”.

If date, the property job_start_date should provide the date.

job_start_datestring | null(date-time)

If job_start is “date”, this provides what the start date is.

languagestring | null

The language in which this job advertisement is written.

If you requested a different language, this means the requested language does not exist.
Some fields will still be in the requested language, but not the free text fields.

language_informationstring | null

Free text with additional information about the language capabilities for applicants.

E.g. “Französisch von Vorteil”

linkstring | null

Job detail page weblink.

mediaOne Of

Information to show image or video for this job.

Mediaobject

An image or video reference.

Show Child Parameters
meet_the_teamarray | null[string]

List of links to linked.in to show cards.

positionstring | null

Job position that is being offered.

E.g. employee, trainee, …

recruiterOne Of

Data about the recruiter for this job.

Recruiterobject

Information about the recruiter of a job.

Show Child Parameters
recruitment_stepsarray | null[string]

Ordered list of steps for applying for this job.

regionstring | null

Name of the region where this job is offered.

E.g. Zurich, Lucerne, …

rubricstring | null

Rubric/classification information about this job.

salary_rangestring | null

Description of the salary range for this job as plain text.

speechstring | null

Whether the job offer is in informal or formal speech (Du vs Sie).

The values can be “informal” or “formal”.

tasksarray | null[string]

Order list of task descriptions to do in this job.

titlestring | null

Job advertisment headline.

typestring | null

The type code of this job, e.g. “job” or “apprenticeship”

workload_frominteger | null

Job workload percentage from.

workload_tointeger | null

Job workload percentage to.

workplace_addressOne Of

Address where the employee will work.

WorkplaceAddressobject

Address where a job takes place.

Show Child Parameters
get/migros/human-resources/v8/jobs/{id}
 
200 application/json

AbstractCollection

A generic collection of elements.

AbstractSearchResultCollection

object

A collection of search result instances.

idsarray[string]

Ids only.

Is filled instead of the usual property for content, with only the ids when a call is made with verbosity=id on a
route that supports it.

total_hitsinteger

The total hits may exceed the actual count of results in the collection.

It represents the total number of results of a search and not only the
potentially paginated subset.

Example

Channel

object
end_datestring(date-time)required
namestringrequired

End date from when the channel is active. i.e. 2022-04-14

start_datestring(date-time)required
Example