Megatix

Modify booking

PATCH /api/partners/{partner_id}/bookings/{booking_id}

The Modify Booking API endpoint allows partners to update a confirmed booking. Partners can provide the updated values and insured parties for the booking attributes for booking modification. This endpoint requires a valid access token obtained from the Authentication.

Depending on the policies, booking modification may result in additional costs.

Path parameters

Parameter	Type	Description
partner_id	string	The partner identifier provided during onboarding
booking_id	string	Unique identifier of the booking returned in the create booking endpoint

Headers

Name	Value
Accept	application/json
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
policies	array
policies[].id	string	Unique identifier of the booking policy
policies[].update_fields	object	All booking attributes that need to be updated should be specified in this object
policies[].update_fields.event_datetime	string/datetime	Updated event date time
policies[].update_fields.policy_start_date	string/datetime	Updated policy start date
policies[].update_fields.policy_end_date	string/datetime	Updated policy end date
policies[].update_fields.number_of_tickets	integer	Updated number of tickets covered in this policy
policies[].update_fields.tickets	array	An array of tickets to be covered in this policy
policies[].update_fields.tickets[].price	decimal	The price of the ticket
policies[].update_fields.tickets[].type	string	Ticket type
policies[].update_fields.tickets[].scanned_at	string/datetime	The date time when the ticket was scanned.
policies[].update_fields.insured	array	A list of insured
policies[].update_fields.insured[].first_name	string	First name
policies[].update_fields.insured[].last_name	string	Last name
policies[].update_fields.insured[].email	string	Email address
policies[].update_fields.insured[].country	string	Two letters country code
policies[].update_fields.insured[].address1	string	Address line 1
policies[].update_fields.insured[].address2	string	Address line 2
policies[].update_fields.insured[].city	string	City of residence
policies[].update_fields.insured[].region	string	Region
policies[].update_fields.insured[].postcode	string	Postcode
policies[].update_fields.insured[].phone	string	Phone number
policies[].update_fields.insured[].birth_date	string	Date of birth
policies[].update_fields.insured[].company	string	Company name

{
  "policies": [
    {
      "id": "dcea9814-3c5a-4be3-bfc6-4be842f46542",
      "update_fields": {
        "event_datetime": "2024-08-21T04:55:06.649Z",
        "policy_start_date": "2024-07-12T04:55:06.649Z",
        "number_of_tickets": 1,
        "policy_end_date": "2024-08-21T04:55:06.649Z",
        "tickets": [
          {
            "price": 35,
            "type": "Second Release",
            "scanned_at": null
          }
        ],
        "insured": [
          {
            "first_name": "Katrina",
            "last_name": "Brown modified"
          }
        ]
      }
    }
  ]
}

Response

🟢 201

{
    "data": {
        "provider_reference": "QBVWG-627R7-INS",
        "language": "en",
        "provider_customer_id": null,
        "status": "Active",
        "currency": "AUD",
        "price": 8.08,
        "security_token": "KUvFe-fcVDe-hyFXL-LdTza",
        "created_at": "2024-07-22T04:55:07.000000Z",
        "updated_at": "2024-07-22T04:57:50.000000Z",
        "is_instant_booking": false,
        "policies": [
            {
                "status": "Active",
                "policy_start_date": "2024-07-12T00:00:00.000000Z",
                "policy_end_date": "2024-08-21T00:00:00.000000Z",
                "price": 8.08,
                "tax": 0.73,
                "commission": 3.49,
                "cover_amount": null,
                "policy_type": "event_ticket_protection",
                "policy_code": "MECMTX01",
                "policy_version": "27b24e36-6bd5-4e68-8af1-64d928ff9c87",
                "policy_content": {
                    "title": "Missed Event Protection",
                    "header": null,
                    "description": "Ticket Protection",
                    "optout_msg": "",
                    "inclusions": [],
                    "exclusions": [],
                    "disclaimer": "By clicking the button you confirm that you have read and agreed to the Terms and Conditions. The Missed Event Protection plan is a service provided by XCover.com, a trading name of Booking Protect Ltd.",
                    "disclaimer_html": "<p data-block-key=\"qbt5v\">By clicking the button you confirm that you have read and agreed to the <a href=\"https://staging.xcover.com/en/pds/QBVWG-627R7-INS?policy_type=event_ticket_protection_v3\" rel=\"noopener noreferrer\" target=\"_blank\">Terms and Conditions</a>. The Missed Event Protection plan is a service provided by XCover.com, a trading name of Booking Protect Ltd.</p>",
                    "payment_disclaimer": "",
                    "in_path_disclaimer": ""
                },
                "claim_selector_id": "a3cee99c-079a-44ff-a555-546223ad2863",
                "pds_url": "https://staging.xcover.com/en/pds/QBVWG-627R7-INS?policy_type=event_ticket_protection_v3",
                "extra_fields": {
                    "retail_premium": "8.084999999999999895083924173",
                    "uw_fee": "1.889999999999999857197563458",
                    "get_tickets": [
                        {
                            "type": "Second Release",
                            "price": 35,
                            "scanned_at": null
                        },
                        {
                            "type": "Second Release",
                            "price": 35,
                            "scanned_at": null
                        },
                        {
                            "type": "Second Release",
                            "price": 35,
                            "scanned_at": null
                        }
                    ],
                    "cg_revenue": "1.970000000000000142802436542"
                },
                "confirmed_at": "2024-07-22T04:55:07.000000Z",
                "cancelled_at": null,
                "created_at": "2024-07-22T04:55:07.000000Z",
                "updated_at": "2024-07-22T04:57:50.000000Z",
                "id": "dcea9814-3c5a-4be3-bfc6-4be842f46542"
            }
        ],
        "policyholder": {
            "first_name": "Kaitlin",
            "last_name": "Brown",
            "email": "[email protected]",
            "phone": "[phone]",
            "country": "AU",
            "date_of_birth": null,
            "address1": "50827 Halvorson Way",
            "address2": null,
            "city": "Sydney",
            "region": "NSW",
            "postcode": "68988-3838",
            "created_at": "2024-07-22T04:55:07.000000Z",
            "updated_at": "2024-07-22T04:55:07.000000Z",
            "id": "83995766-4d6f-4e62-9114-cb4d05e6a0c5"
        },
        "id": "c74babe3-c9c0-479f-a3cb-7a566d55dfd7",
        "partner": {
            "uuid": "24430a18-8c73-4bd5-8dab-07de4e7c7603",
            "name": "Megatix"
        },
        "quote": {
            "uuid": "b2e8c2db-c304-4354-80fb-4c90d2ae99ff"
        },
        "cancellations": []
    }
}

🔴 401

{
    "message": "Unauthenticated."
}

🔴 422

{
    "message": "The request is invalid."
}