1. Jobs
Swoovo — OTA Pull Endpoint
  • For OTA Hotels
    • List hotels (paginated)
      GET
  • Push Rooms
    • Push rooms (async)
      POST
  • Push Inventory
    • Push inventory (async)
      POST
  • Push Rates
    • Push rates (async)
      POST
  • Push Overrides Price & Inventory
    • Push inventory overrides (async)
      POST
    • Push pricing overrides (async)
      POST
  • Mapped Properties
    • List mapped properties
      POST
  • Jobs
    • Get room push job status
      GET
    • Get inventory push job status
      GET
    • Get rates push job status
      GET
    • Get override job status
      GET
  • Schemas
    • HotelListResponse
    • ErrorResponse
    • Hotel
    • AsyncJobAcceptedResponse
    • HotelImage
    • PushRoomsRequest
    • RoomData
    • RoomImage
    • BaseInventoryEmbed
    • RoomRateEmbed
    • ChildPricingRules
    • ChildPricingThreshold
    • PushInventoryRequest
    • BaseInventoryItem
    • InventoryOverrideItem
    • PushRatesRequest
    • RoomRateInput
    • PushInventoryOverridesRequest
    • InventoryOverrideRequest
    • PushPricingRulesRequest
    • PricingRuleRequest
    • JobStatusResponse
    • JobStatusData
    • RoomJobStatusResponse
    • RoomJobStatusData
    • InventoryJobStatusResponse
    • InventoryJobStatusData
    • RatesJobStatusResponse
    • RatesJobStatusData
    • MappedPropertiesResponse
    • MappedProperty
  1. Jobs

Get override job status

GET
/api/v1/jobs/status
Poll the status of an override job (inventory or pricing).
This endpoint only accepts numeric job IDs (returned by
/push/inventory-overrides and /push/pricing-overrides).
Do not pass room/inventory/rates job IDs here — use their
dedicated status endpoints instead.
Jobs typically complete within 2–30 seconds, depending on payload
size. Failed jobs have a populated last_error field.

Request

Authorization
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************
or
Query Params

Responses

🟢200
application/json
Job status retrieved
Bodyapplication/json

🟠400BadRequest
🟠404NotFound
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/jobs/status?job_id=undefined' \
--header 'X-API-Key: <api-key>'
Response Response Example
200 - Job completed successfully
{
    "status": true,
    "message": "Job status retrieved",
    "data": {
        "job_id": "42",
        "job_type": "inventory_override",
        "ota_id": 1,
        "status": "completed",
        "attempts": 1,
        "max_attempts": 5,
        "created_at": "2026-10-15T12:30:45Z",
        "started_at": "2026-10-15T12:30:47Z",
        "completed_at": "2026-10-15T12:30:47Z"
    }
}
Modified at 2026-11-12 09:12:10
Previous
Get rates push job status
Next
HotelListResponse
Built with