VISA HR GLOBAL
Developer & Integration Guide

Job Feed Specifications & ATS API Documentation

Technical guide for ATS developers, job board publishers, and engineering partners syndicating international job postings to VISA HR GLOBAL (https://visahr.in).

Live Sample Test Feeds Available

Download our reference XML, JSON, and RSS templates to test feed validation before publishing:

1 XML Feed Specification

Our XML parser adheres to standard job board schemas. We support custom root tags (e.g. <jobs>, <source>) and item elements (<job>, <position>).

<?xml version="1.0" encoding="UTF-8"?>
<source>
  <publisher>Global Career Network</publisher>
  <publisherurl>https://example.com</publisherurl>
  <lastBuildDate>2026-03-30T10:00:00Z</lastBuildDate>
  <job>
    <title><![CDATA[Senior Structural Engineer (Offshore)]]></title>
    <date>2026-03-30T09:30:00Z</date>
    <referencenumber>JOB-UAE-2026-01</referencenumber>
    <url><![CDATA[https://example.com/apply/job-uae-01]]></url>
    <company><![CDATA[Al-Futtaim Engineering]]></company>
    <city>Dubai</city>
    <country>United Arab Emirates</country>
    <description><![CDATA[<p>Looking for experienced offshore structural engineer...</p>]]></description>
    <salary><![CDATA[AED 22,000 - 28,000 / month]]></salary>
    <category>Engineering & Technical</category>
    <visasponsorship>1</visasponsorship>
    <accommodation>1</accommodation>
    <transportation>1</transportation>
    <airticket>Annual round-trip air ticket provided</airticket>
  </job>
</source>

2 JSON Feed Specification

JSON feeds may provide an array at the root or under an object key like jobs, data, or vacancies.

{
  "publisher": "Gulf Careers ATS",
  "generated_at": "2026-03-30T10:00:00Z",
  "jobs": [
    {
      "id": "GC-8831",
      "title": "Hospital Registered Nurse (ICU)",
      "company": "King Faisal Specialist Hospital",
      "country": "Saudi Arabia",
      "city": "Riyadh",
      "employment_type": "full_time",
      "salary": "SAR 14,000 - 18,000",
      "description": "Registered nurses needed with min 3 years ICU experience. Full Saudi employment visa sponsored.",
      "application_url": "https://example.com/jobs/gc-8831?utm_source=visahr",
      "visa_sponsorship": true,
      "benefits": {
        "accommodation": true,
        "flight_allowance": true,
        "medical_insurance": true
      }
    }
  ]
}

3 Schema.org JobPosting JSON-LD Ingestion

If your career site renders Google-compliant JobPosting structured data, Visa HR Global can discover and parse listings directly from your accessible HTML web pages:

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "JobPosting",
  "title": "Cloud DevOps Engineer (Terraform / AWS)",
  "description": "<p>Lead international cloud migrations in Frankfurt, Germany...</p>",
  "datePosted": "2026-03-25",
  "validThrough": "2026-06-30",
  "employmentType": "FULL_TIME",
  "hiringOrganization": {
    "@type": "Organization",
    "name": "FinTech Global AG",
    "sameAs": "https://example.de"
  },
  "jobLocation": {
    "@type": "Place",
    "address": {
      "@type": "PostalAddress",
      "addressLocality": "Frankfurt",
      "addressCountry": "DE"
    }
  },
  "baseSalary": {
    "@type": "MonetaryAmount",
    "currency": "EUR",
    "value": {
      "@type": "QuantitativeValue",
      "minValue": 75000,
      "maxValue": 90000,
      "unitText": "YEAR"
    }
  }
}
</script>

4 Inbound ATS REST APIs & Webhooks

Authorized partners can syndicate vacancies, execute bulk ingestions, update live postings, and receive event callbacks via our high-speed RESTful gateway.

API Authentication & Rate Limits:
• Provide header X-ATS-Key: <API_KEY> or Authorization: Bearer <TOKEN>
• Submission Rate Limit: 60 requests/minute per API key
• Outbound Query Rate Limit: 120 requests/minute per IP/Key
• Payload formats: application/json (UTF-8 encoded)
POST https://visahr.in/api/v1/ats/jobs Submit Single Vacancy
{
  "title": "Lead Piping & Pipeline Commissioning Engineer",
  "company_name": "Aramco Overseas Contractor",
  "source_job_id": "ATS-KSA-9081",
  "country": "Saudi Arabia",
  "city": "Dammam",
  "category": "Engineering & Construction",
  "salary_min": 18000,
  "salary_max": 24000,
  "salary_currency": "SAR",
  "employment_type": "full_time",
  "visa_sponsorship": true,
  "application_url": "https://partner-ats.com/apply/ksa-9081",
  "description": "Commissioning offshore gas pipelines and sour service processing units..."
}
POST https://visahr.in/api/v1/ats/jobs/bulk Submit Bulk Batch (Up to 100 jobs)
{
  "jobs": [
    { "title": "Civil Structural Lead", "company": "Petrofac", "country": "UAE", "application_url": "https://..." },
    { "title": "ICU Senior Nurse", "company": "Cleveland Clinic Abu Dhabi", "country": "UAE", "application_url": "https://..." }
  ]
}
PUT /api/v1/ats/jobs/{source_job_id}

Update salary, description, title, or visa attributes of an existing posting in-place.

DELETE /api/v1/ats/jobs/{source_job_id}

Close and immediately expire a filled or cancelled vacancy across Visa HR Global.

5 Outbound Job Access APIs

Syndication partners and authorized mobile applications can retrieve active published jobs programmatically:

GET https://visahr.in/api/v1/jobs Query Active Jobs
Query Parameters Supported:
country=UAE
category=engineering
visa_sponsorship=1
search=pipe
per_page=50
page=1

5 Canonical Field Mapping Reference

The Visa HR Global Field Mapping Engine automatically normalizes various common publisher field names to our internal canonical schema:

Canonical Field Allowed Publisher Aliases Type Description
title title, job_title, position, role String (100) Clear job position headline
company company, employer, company_name, hiringOrganization String (150) Hiring employer or agency name
description description, job_description, details, body HTML / Text Sanitized job responsibilities and requirements
country country, country_name, jobLocation, nation String / ISO-2 Resolved against our global countries registry
city city, location, addressLocality String (100) Destination employment city
apply_url url, apply_url, link, application_url URL Target application URL for candidate redirect
visa_sponsorship visa, visa_sponsorship, visa_sponsored Boolean / 1,0 Highlights job to Indian overseas jobseekers

Visa HR Global Outbound Job Feeds

Partner aggregators may also ingest our machine-readable public outbound job feeds: