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 room push job status

GET
/api/v1/rooms/status
Poll the status of a room push job.
Poll every 2–5 seconds. Job lifetime in memory is a few hours —
if you receive 404 Job not found or expired, treat the push
as lost and re-send.

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/rooms/status?job_id=undefined' \
--header 'X-API-Key: <api-key>'
Response Response Example
200 - Success
{
    "status": true,
    "message": "Job status retrieved",
    "data": {
        "job_id": "rooms_1_1703123456789",
        "status": "completed",
        "ota_id": 1,
        "ota_property_id": "HOTEL12345",
        "total_rooms": 2,
        "processed_rooms": 2,
        "successful_rooms": 2,
        "failed_rooms": 0,
        "errors": [],
        "start_time": "2025-01-15T10:30:00Z",
        "end_time": "2025-01-15T10:30:05Z"
    }
}
Modified at 2026-11-12 09:12:10
Previous
List mapped properties
Next
Get inventory push job status
Built with