# The job object

Each job in the feed has exactly these fields. We may add fields over time, so ignore any you don’t know; we won’t remove or rename one without telling you first.

| JSON field | Description | XML |
| --- | --- | --- |
| `id` | Stable MuslimJobs job id. Use it as your key. | `<referencenumber>` |
| `title` | Job title. | `<title>` |
| `company.name` | Company name. | `<company>` |
| `company.logo_url` | Square PNG logo (at most 256px) on MuslimJobs, or null. | `<logo>` |
| `company.url` | Company page on MuslimJobs, with your ref. | `<companyurl>` |
| `location.city` | City, or null. | `<city>` |
| `location.country` | Country. | `<country>` |
| `location.remote` | REMOTE, HYBRID or ONSITE. | `<remotetype>` |
| `location.remote_label` | Display label for remote. | `<remotetype label>` |
| `job_type` | Type of contract. | `<jobtype>` |
| `job_type_label` | Display label for job_type. | `<jobtype label>` |
| `category` | Job category. | `<category>` |
| `category_label` | Display label for category. | `<category label>` |
| `salary` | Salary as display text, e.g. "GBP 70,000 - 85,000 / year". | `<salary>` |
| `experience.min_years` | Minimum years, or null. | `<experience min>` |
| `experience.max_years` | Maximum years, or null. | `<experience max>` |
| `description_html` | Description as HTML: p, br, strong, em, ul, ol, li, a, h2–h4 only. | `<description>` |
| `description_text` | Description as plain text with line breaks, for apps that can’t render HTML. | `(JSON only)` |
| `tags` | Skills and keywords. May be empty. | `<tags> (comma separated)` |
| `url` | Job page on MuslimJobs, with your ref. | `<url>` |
| `apply_url` | Job page with apply=1. Use it unchanged for apply buttons. | `<applyurl>` |
| `published_at` | When the job went live (ISO 8601). | `<date>` |
| `updated_at` | When the job last changed (ISO 8601). | `<updated>` |
| `expires_at` | When the job closes (ISO 8601), or null. | `<expirationdate>` |
| `attribution.text` | Show this next to every job. | `<attribution text>` |
| `attribution.url` | Link the attribution here. | `<attribution url>` |
| `attribution.logo_url` | MuslimJobs logo, SVG. | `<attribution logo>` |
| `attribution.logo_png_url` | MuslimJobs logo, PNG, for apps that can’t draw SVG. | `<attribution logopng>` |

## Values

`location.remote`, `job_type` and `category` are codes. Each comes with a `_label` field holding the text to show, so you don’t need your own copy of these lists.

### `location.remote`

| Value | Label |
| --- | --- |
| `REMOTE` | Remote |
| `HYBRID` | Hybrid |
| `ONSITE` | Onsite |

### `job_type`

| Value | Label |
| --- | --- |
| `FULL_TIME` | Full-time |
| `PART_TIME` | Part-time |
| `CONTRACT` | Contract |
| `INTERNSHIP` | Internship |
| `OTHER` | Other |

### `category`

| Value | Label |
| --- | --- |
| `ENGINEERING_AND_TECHNOLOGY` | Engineering and Technology |
| `SALES_AND_MARKETING` | Sales and Marketing |
| `DATA_AND_ANALYTICS` | Data and Analytics |
| `CUSTOMER_SERVICE` | Customer Service |
| `BUSINESS_AND_FINANCE` | Business and Finance |
| `MEDIA` | Media |
| `EDUCATION` | Education |
| `HEALTH_AND_MEDICINE` | Health and Medicine |
| `LAW_AND_POLICY` | Law and Policy |
| `OTHER` | Other |
| `PRODUCT_AND_DESIGN` | Product and Design |
| `ADMINISTRATION` | Administration |
| `HUMAN_RESOURCES` | Human Resources |
| `MANAGEMENT` | Management |

## Descriptions

`description_html` uses only `p`, `br`, `strong`, `em`, `ul`, `ol`, `li`, `a` and `h2` to `h4`. Links to other sites, email addresses and web addresses are removed, so candidates apply on MuslimJobs. Use `description_text`, plain text with line breaks and “• ” for list items, if your app can’t show HTML.

