# Get job status

Get the current status of a trip creation job. This endpoint is public and does not require authentication.

Status values:
- processing: Job is still running
- completed: Trip has been created successfully
- error: Job failed with an error
- canceled: Job was canceled

Stage values (during processing):
- initializing: Starting the job
- extractingText: Extracting text from the document
- generatingBlocks: Generating trip structure with AI
- enrichingBlocks: Enriching blocks with real-world data (flights, places, images)
- completed: Processing finished

When status is completed, the publicUrl and builderUrl will point to the actual trip pages.

Endpoint: GET /ai/trips/{publicId}/status
Version: 1.0.0
Security: 

## Path parameters:

  - `publicId` (string, required)
    Public UUID of the job
    Example: "1c2c38f3-e596-463e-9f62-75c7c3602770"

## Response 200 fields (application/json):

  - `jobId` (string, required)
    Unique public identifier for the job
    Example: "1c2c38f3-e596-463e-9f62-75c7c3602770"

  - `status` (string, required)
    Current status of the job
    Enum: "processing", "completed", "error", "canceled"

  - `stage` (string, required)
    Current processing stage
    Enum: "initializing", "extractingText", "generatingBlocks", "enrichingBlocks", "completed"

  - `publicUrl` (string, required)
    URL to the trip public page
    Example: "https://v2.app.moguplatform.com/ai/trip/public/1c2c38f3-e596-463e-9f62-75c7c3602770"

  - `builderUrl` (string, required)
    URL to the trip builder (requires authentication)
    Example: "https://v2.app.moguplatform.com/ai/trip/1c2c38f3-e596-463e-9f62-75c7c3602770"

  - `tripId` (integer,null, required)
    Trip ID if completed, null otherwise

  - `tripSlug` (string,null, required)
    Trip slug if completed, null otherwise

  - `error` (string)
    Error message if status is error
    Example: "Could not extract trip information from document"

  - `updatedAt` (string, required)
    Last update timestamp (ISO 8601)
    Example: "2026-01-27T15:30:28Z"

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.code` (string, required)
    Error code
    Enum: "invalid_source", "invalid_url", "unsupported_format", "job_not_cancelable", "missing_api_key", "invalid_api_key", "job_not_found"

  - `error.message` (string, required)
    Human readable error message
    Example: "Source configuration is invalid"