Skip to content
aerandil.com
GitHub

Read Channel reservation delivery

GET
/v1/object-types/hospitality.channel_reservation_delivery/objects/{id}
curl --request GET \
  --url https://api.aerandil.com/v1/object-types/hospitality.channel_reservation_delivery/objects/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>'

Read an existing instance.

One inbound reservation message from a partner, with its de-duplication and acknowledgement state. Every channel wire is at-least-once — SiteMinder re-pushes every minute for ten attempts then every five, Booking.com re-serves anything unacknowledged inside its pickup window — so duplicate delivery is the norm and external_message_id is the key that makes a replay a no-op. The message is a report of a sale that already completed on the partner’s side, not a request: where inventory is short, this row records the oversell rather than refusing the booking.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

Object id (UUID v7, server-generated at create time).

Query Parameters

Section titled “Query Parameters”
branch
string format: uuid

Read through an open branch’s copy-on-first-write overlay view instead of the canonical (main) plane. Does not compose with as_of (422). The branch must exist under the caller’s tenant.

Responses

Section titled “Responses”

200

Section titled “200”

Object found.

Media typeapplication/json
object
created_at
required
string format: date-time
id
required
string format: uuid
object_type
required
Allowed value: hospitality.channel_reservation_delivery
properties
required
object
acknowledged_at
When our acknowledgement was sent to the partner
string format: date-time
applied_at
When the message landed in the ontology
string format: date-time
connection_ref
required
Business id of the conduit this arrived on (scopes the de-duplication key)
string
external_message_id
required
The partner's identifier for this message (de-duplication key)
string
external_reservation_id
required
The partner's identifier for the reservation (stable across book/modify/cancel)
string
id
required
Delivery id
string
intent
required
What the message asks of us
string
Allowed values: book modify cancel
notes
Free-form operator notes
string
origin_channel_code
The partner's code for the demand channel that sold the booking
string
oversold_by
Rooms the property went over its selling ceiling to accept this booking
integer
payload_digest
Digest of the verbatim partner payload held in raw staging
string
received_at
required
When the message reached us
string format: date-time
rejection_detail
Operator-facing detail behind the rejection
string
rejection_kind
Why the message was permanently refused (state = rejected)
string
Allowed values: unmapped_room_type unmapped_rate_plan unknown_property connection_inactive invalid_stay_dates malformed_payload business_rule other
status
required
Delivery lifecycle state
string
Allowed values: received applied rejected failed
provenance

Per-property source attribution and pins. An entry under properties means the property’s current value came from that source (on the source’s own clock, source_updated_at); an entry under pins is a human override protecting the property from sourced writes.

object
pins
object
key
additional properties
object
pinned_at
string format: date-time
pinned_by
object
reason
required
string
properties
object
key
additional properties
object
external_id
string
recorded_at
required
string format: date-time
source
required
string
source_updated_at
string format: date-time
stream
string
scope
required
One of: discriminator: level
object
level
required
string
Allowed value: tenant
Allowed values: tenant
tenant_id
required
string format: uuid
updated_at
required
string format: date-time
version
required
integer
>= 1
Example
{
  "object_type": "hospitality.channel_reservation_delivery",
  "properties": {
    "intent": "book",
    "rejection_kind": "unmapped_room_type",
    "status": "received"
  },
  "scope": {
    "level": "tenant"
  }
}

Headers

Section titled “Headers”
ETag
string
/^"\d+"$/

Quoted strong validator (RFC 7232 §2.3) carrying the object’s monotonic version. Informational on the read path — object mutation goes through typed actions on /v1/actions/{action}/apply, not raw CRUD.

404

Section titled “404”

No object with that id (or soft-deleted).