---
title: "Publication"
url: "https://real-estate-agency.apim.eu/apis/listing-creation/versions/ccce93aa-5880-49f4-849d-af24517f6c76/schemas/Publication"
---

> Full API specification: https://real-estate-agency.apim.eu/apis/listing-creation/versions/ccce93aa-5880-49f4-849d-af24517f6c76.md

# Publication

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Listing Creation
  version: 1.0.0
servers:
  - url: https://api.realestateagency.example/v1
    description: Production
  - url: https://sandbox.api.realestateagency.example/v1
    description: Sandbox - data is reset nightly
components:
  schemas:
    ListingStatus:
      type: string
      description: Lifecycle of a listing.
      enum:
        - in_progress
        - completed
        - published
        - withdrawn
        - failed
      example: completed
    Channel:
      type: string
      description: Publication channel.
      enum:
        - portal
        - website
        - newsletter
        - shop_window
    Publication:
      type: object
      properties:
        listing_id:
          type: string
          example: lst_4d9b2e
        status:
          $ref: "#/components/schemas/ListingStatus"
        channels:
          type: array
          items:
            type: object
            properties:
              channel:
                $ref: "#/components/schemas/Channel"
              state:
                type: string
                enum:
                  - live
                  - scheduled
                  - failed
              url:
                type: string
                format: uri
        published_at:
          type: string
          format: date-time
          example: 2026-08-20T09:44:03Z
```