Bookings

patch

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Path parameters

idstring · uuidRequired

Header parameters

api-versionstringOptional

younium-idempotency-keystringOptional

younium-idempotency-durationInHoursintegerOptional

Body

application/merge-patch+json

bookingTypestring · enumOptionalPossible values:

accountCategorystring · enumOptionalPossible values:

changeTypestring · enumOptionalPossible values:

notesstring · nullableOptional

effectiveDatestring · date-time · nullableOptional

Responses

204

No Content

No content

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

404

Not Found

application/json

patch

/Bookings/{id}

HTTPcURLJavaScriptPython

PATCH /Bookings/{id} HTTP/1.1
Host: api.sandbox.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/merge-patch+json
Accept: */*
Content-Length: 170

{
  "bookingType": "New",
  "accountCategory": "New",
  "changeType": "Upsell",
  "notes": "text",
  "effectiveDate": "2026-05-14T02:10:32.157Z",
  "classification": "BookingClassificationName"
}

No content

Get Bookings by Id

get

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Path parameters

idstring · uuidRequired

Header parameters

api-versionstringOptional

Responses

200

Success

application/json

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

404

Not Found

application/json

get

/Bookings/{id}

HTTPcURLJavaScriptPython

GET /Bookings/{id} HTTP/1.1
Host: api.sandbox.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "currency": "text",
  "bookingType": "New",
  "accountCategory": "New",
  "changeType": "Upsell",
  "cmrr": {
    "amount": 1,
    "amountInBaseCurrency": 1
  },
  "acv": {
    "amount": 1,
    "amountInBaseCurrency": 1
  },
  "emrr": {
    "amount": 1,
    "amountInBaseCurrency": 1
  },
  "oneTimeFees": {
    "amount": 1,
    "amountInBaseCurrency": 1
  },
  "tcv": {
    "amount": 1,
    "amountInBaseCurrency": 1
  },
  "fmrr": {
    "amount": 1,
    "amountInBaseCurrency": 1
  },
  "effectiveDate": "2026-05-14T02:10:32.157Z",
  "bookingLines": [
    {
      "charge": {
        "name": "text",
        "chargeNumber": "OPC-000001",
        "description": "text",
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "externalERPId": "text",
        "externalCRMId": "text"
      },
      "cmrr": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-05-14T02:10:32.157Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "acv": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-05-14T02:10:32.157Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "emrr": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-05-14T02:10:32.157Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "oneTimeFees": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-05-14T02:10:32.157Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "tcv": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-05-14T02:10:32.157Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "fmrr": {
        "amount": 1,
        "currencyCode": "text",
        "currencyConversionDate": "2026-05-14T02:10:32.157Z",
        "baseCurrencyAmount": 1,
        "baseCurrencyCode": "text"
      },
      "created": "2026-05-14T02:10:32.157Z",
      "modified": "2026-05-14T02:10:32.157Z"
    }
  ],
  "classification": {
    "name": "text",
    "description": "text",
    "chartColor": "text",
    "isSystemClassification": true,
    "classificationType": "NewCustomer"
  },
  "created": "2026-05-14T02:10:32.157Z",
  "modified": "2026-05-14T02:10:32.157Z",
  "order": {
    "orderNumber": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "externalERPId": "text",
    "externalCRMId": "text"
  },
  "notes": "text"
}

get

Required scopes

This endpoint requires the following scopes:

• : Access Younium API

Authorizations

oauth2

OAuth2passwordRequired

Token URL:

Query parameters

Skipinteger · int32Optional

Skip number of records

Example: 10

Takeinteger · int32Optional

Take number of records

Example: 5

FilterstringOptional

Filter the resulsts. See ODATA documentation for more information

Example: name eq 'Adam' and age gt 20

SortstringOptional

Sorting the results. See ODATA specificaion for more information

Example: name

Header parameters

api-versionstringOptional

Responses

200

Success

application/json

400

Bad Request.

application/json

401

Unauthorized

403

Forbidden

get

/Bookings

HTTPcURLJavaScriptPython

GET /Bookings HTTP/1.1
Host: api.sandbox.younium.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "currency": "text",
    "bookingType": "New",
    "accountCategory": "New",
    "changeType": "Upsell",
    "cmrr": {
      "amount": 1,
      "amountInBaseCurrency": 1
    },
    "acv": {
      "amount": 1,
      "amountInBaseCurrency": 1
    },
    "emrr": {
      "amount": 1,
      "amountInBaseCurrency": 1
    },
    "oneTimeFees": {
      "amount": 1,
      "amountInBaseCurrency": 1
    },
    "tcv": {
      "amount": 1,
      "amountInBaseCurrency": 1
    },
    "fmrr": {
      "amount": 1,
      "amountInBaseCurrency": 1
    },
    "effectiveDate": "2026-05-14T02:10:32.157Z",
    "bookingLines": [
      {
        "charge": {
          "name": "text",
          "chargeNumber": "OPC-000001",
          "description": "text",
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "externalERPId": "text",
          "externalCRMId": "text"
        },
        "cmrr": {
          "amount": 1,
          "currencyCode": "text",
          "currencyConversionDate": "2026-05-14T02:10:32.157Z",
          "baseCurrencyAmount": 1,
          "baseCurrencyCode": "text"
        },
        "acv": {
          "amount": 1,
          "currencyCode": "text",
          "currencyConversionDate": "2026-05-14T02:10:32.157Z",
          "baseCurrencyAmount": 1,
          "baseCurrencyCode": "text"
        },
        "emrr": {
          "amount": 1,
          "currencyCode": "text",
          "currencyConversionDate": "2026-05-14T02:10:32.157Z",
          "baseCurrencyAmount": 1,
          "baseCurrencyCode": "text"
        },
        "oneTimeFees": {
          "amount": 1,
          "currencyCode": "text",
          "currencyConversionDate": "2026-05-14T02:10:32.157Z",
          "baseCurrencyAmount": 1,
          "baseCurrencyCode": "text"
        },
        "tcv": {
          "amount": 1,
          "currencyCode": "text",
          "currencyConversionDate": "2026-05-14T02:10:32.157Z",
          "baseCurrencyAmount": 1,
          "baseCurrencyCode": "text"
        },
        "fmrr": {
          "amount": 1,
          "currencyCode": "text",
          "currencyConversionDate": "2026-05-14T02:10:32.157Z",
          "baseCurrencyAmount": 1,
          "baseCurrencyCode": "text"
        },
        "created": "2026-05-14T02:10:32.157Z",
        "modified": "2026-05-14T02:10:32.157Z"
      }
    ],
    "classification": {
      "name": "text",
      "description": "text",
      "chartColor": "text",
      "isSystemClassification": true,
      "classificationType": "NewCustomer"
    },
    "created": "2026-05-14T02:10:32.157Z",
    "modified": "2026-05-14T02:10:32.157Z",
    "order": {
      "orderNumber": "text",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalERPId": "text",
      "externalCRMId": "text"
    },
    "notes": "text"
  }
]

---