Job publishing API

1. Get a token

1. Sign in as a company and complete verification (needed to submit jobs for approval).
2. Open API in the menu (/company/api) and create a token. Copy it — it is shown once.
3. Send it with every request: Authorization: Bearer <token> and Accept: application/json.

Download the Postman collection — import it in Postman, set the token variable, and every request below is ready to send.

Base URL: https://jorajobs.com/api/v1 · Rate limit: 60 requests per minute per company.

2. Endpoints

3. How a job moves

• New jobs are submitted for approval (status pending). Send "submit": false to keep a draft.
• An administrator approves (live) or rejects (rejected, with rejection_reason). Poll GET /jobs/{id} to follow it.
• Updating a live job keeps it live. Updating a rejected job and sending "submit": true sends it back for approval.
• Unverified companies can only create drafts; submitting returns 403 company_not_verified.

4. Native format

Required: title, category (id, slug or name), description, country (name or ISO code, see GET /options), city, deadline_at (within a year). New regions (state) and cities are added automatically. salary_currency and salary_period are required when you send an amount. questions takes up to 10 strings or objects (type: text, yes_no, number).

curl -X POST https://jorajobs.com/api/v1/jobs \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d @job.json

{
    "external_id": "ATS-2026-0042",
    "title": "Senior Laravel Developer",
    "category": "information-communication-technology",
    "sub_category": "Software Development",
    "employment_type": "full_time",
    "work_arrangement": "hybrid",
    "job_level": "senior",
    "vacancies": 2,
    "experience_min": 4,
    "experience_max": 8,
    "education_requirement": "BSc in CSE or related",
    "skills": [
        "Laravel",
        "MySQL",
        "REST"
    ],
    "abstract": "Build and scale our hiring platform.",
    "description": "<p>You will design APIs…</p><ul><li>4+ years with Laravel</li></ul>",
    "salary_min": 120000,
    "salary_max": 160000,
    "salary_currency": "BDT",
    "salary_period": "month",
    "salary_negotiable": true,
    "country": "Bangladesh",
    "country_code": "BD",
    "city": "Dhaka",
    "area": "Gulshan",
    "deadline_at": "2026-12-05",
    "questions": [
        "What is your notice period?",
        {
            "question": "Have you used Laravel queues in production?",
            "type": "yes_no",
            "required": true
        }
    ],
    "submit": true
}

5. Job board (data.jobDetails) format

Send the same JSON you send to other job boards. Fields about the other platform (tracking, insights, SEO, reviews, branding, advertiser and company profile) are ignored — your company always comes from the token. Any native field sent next to data overrides the converted value, for example {"data": {…}, "category": "sales", "submit": false}.

{
    "data": {
        "jobDetails": {
            "job": {
                "id": "94933960",
                "title": "DELIVERY MANAGER & RELEASE MANAGER",
                "abstract": "DELIVERY MANAGER & RELEASE MANAGER",
                "content2": "<p><strong>WE’RE HIRING</strong> …</p>",
                "isExpired": false,
                "isLinkOut": false,
                "expiresAt": {
                    "dateTimeUtc": "2026-11-19T14:17:36.612Z"
                },
                "salary": {
                    "currencyLabel": "PHP",
                    "label": "₱120,000 – ₱130,000 per month"
                },
                "workTypes": {
                    "label": "Full time"
                },
                "tracking": {
                    "classificationInfo": {
                        "classification": "Information & Communication Technology",
                        "subClassification": "Programme & Project Management"
                    },
                    "locationInfo": {
                        "location": "Taguig City"
                    }
                },
                "products": {
                    "questionnaire": {
                        "questions": [
                            "What's your expected monthly basic salary?"
                        ]
                    }
                }
            },
            "gfjInfo": {
                "location": {
                    "countryCode": "PH",
                    "country": "Philippines",
                    "suburb": "Bonifacio Global City",
                    "state": "Metro Manila",
                    "postcode": null
                },
                "workTypes": {
                    "label": [
                        "FULL_TIME"
                    ]
                }
            },
            "workArrangements": {
                "arrangements": [
                    {
                        "type": "ONSITE",
                        "label": "On-site"
                    }
                ]
            }
        }
    }
}

6. Responses and errors

Jobs are returned as {"data": {…}} with id, external_id, status, rejection_reason, public_url (once approved), salary, location, questions and dates. POST /jobs also returns meta.created.

• 401 missing or invalid token · 403 missing permission, not_a_company, account_blocked or company_not_verified
• 404 the job does not exist or belongs to another company
• 409 invalid_status, cannot_delete or duplicate_external_id
• 422 validation failed — errors lists the problems per field
• 429 rate limit reached — wait for the Retry-After seconds