v1

latestOpenAPI 3.0.0Apache 2.02026-07-143281,4552.1 MB

BookingCustomAttributes

RetrieveBookingCustomAttribute

Retrieves a bookings custom attribute.

To call this endpoint with buyer-level permissions, set APPOINTMENTS_READ for the OAuth scope. To call this endpoint with seller-level permissions, set APPOINTMENTS_ALL_READ and APPOINTMENTS_READ for the OAuth scope.

get/v2/bookings/{booking_id}/custom-attributes/{key}

Path parameters

booking_idstring required

The ID of the target booking.

keystring required

The key of the custom attribute to retrieve. This key must match the key of a custom attribute definition in the Square seller account. If the requesting application is not the definition owner, you must use the qualified key.

Query parameters

with_definitionboolean

Indicates whether to return the custom attribute definition in the definition field of the custom attribute. Set this parameter to true to get the name and description of the custom attribute, information about the data type, or other definition details. The default value is false.

versioninteger

The current version of the custom attribute, which is used for strongly consistent reads to guarantee that you receive the most up-to-date data. When included in the request, Square returns the specified version or a higher version if one exists. If the specified version is higher than the current version, Square returns a BAD_REQUEST error.

Response

Success

Example response

{
  "custom_attribute": {
    "created_at": "2022-11-16T15:50:27Z",
    "key": "favoriteShampoo",
    "updated_at": "2022-11-16T15:50:27Z",
    "value": "Dune",
    "version": 1,
    "visibility": "VISIBILITY_READ_ONLY"
  },
  "errors": []
}