Vacancy management
Create, retrieve, update, filter, archive, and delete your company vacancies. Assign the responsible company user and upload a vessel photo when needed.
Company integrations
REST API · v1
Connect your recruitment workflow to SeaJobs
A focused API for maritime employers that need to publish and maintain vacancies from their own systems without repeating the same work in multiple tools.
Open API documentation
The complete reference and token management are available in the company dashboard.
A typical vacancy workflow
POST
/api/v1/company/vacancies// Create a company vacancy
201
vacancy_id: 4812// Vacancy created
PATCH
/api/v1/company/vacancies/4812// Keep status and details synchronized
Designed for real integrations
One API, from vacancy publication to candidate review
Use stable IDs and structured responses to connect an ATS, an internal crewing system, or your own automation to SeaJobs.
Maritime reference data
Load ranks, vessel types, engine types, countries, and vacancy options before sending data, so integrations use valid SeaJobs identifiers.
Company ownership
Retrieve active company users and attribute each new vacancy to the appropriate recruiter instead of a single integration account.
Applicant workflow
Premium companies can list applicants to their vacancies, open a full profile, download a CV in PDF or DOCX, and unlink an application from a vacancy.
How access works
A short path from token to synchronization
-
01
Create a token
A company administrator creates a dedicated Bearer token in the API section of the company dashboard.
-
02
Map your data
Load reference IDs and company users, then match them to the fields in your recruitment system.
-
03
Connect and monitor
Send versioned requests, store returned IDs, and handle validation and rate-limit responses in your integration.
Access matched to the workflow
Vacancies and reference data
Available to authenticated company integrations. A Premium subscription is not required for these endpoints.
Applicants to your vacancies
Applicant lists, full profiles, CV downloads, and unlinking applications are available to companies with an active Premium subscription.
Predictable rate limits
Limits are counted separately for each authenticated user. Responses expose standard rate-limit headers to help your integration schedule retries.
400
Read requests · per 10 minutes
100
Write requests · per 10 minutes
Ready to build?
Technical details are waiting in your company dashboard
Sign in to view endpoints, request fields, filters, salary formats, Postman and cURL examples, photo uploads, error responses, and token management.
Open API documentation
Company authentication is required to open the documentation.
