Examples

GET /katello/api/organizations/114267492-Empty%20Organization/subscriptions
200
{
  "organization": {},
  "total": 1,
  "subtotal": 1,
  "selectable": 1,
  "page": 1,
  "per_page": 20,
  "error": null,
  "search": null,
  "sort": {
    "by": "name",
    "order": "asc"
  },
  "results": [
    {
      "id": 128914721,
      "cp_id": "abc123",
      "subscription_id": 904941504,
      "name": "basic subscription",
      "start_date": "2011-10-11 04:00:00 UTC",
      "end_date": "2040-01-01 04:59:59 UTC",
      "available": 9,
      "quantity": 10,
      "consumed": 1,
      "account_number": 12400203,
      "contract_number": 123403949,
      "support_level": "all hands on deck",
      "product_id": null,
      "sockets": 2,
      "cores": 2,
      "ram": 2,
      "instance_multiplier": 1,
      "stacking_id": "stack8473",
      "multi_entitlement": true,
      "type": "normal",
      "product_name": "basic subscription",
      "unmapped_guest": false,
      "virt_only": false,
      "virt_who": true,
      "upstream": true,
      "upstream_pool_id": "100",
      "hypervisor": {
        "id": 980190962,
        "name": "host1.example.com"
      }
    }
  ]
}

Params

Param name Description
search
optional

Search string

Validations:

  • String

page
optional

Page number, starting at 1

Validations:

  • Must be a number.

per_page
optional

Number of results per page to return

Validations:

  • Must be a number.

order
optional

Sort field and order, eg. 'id DESC'

Validations:

  • String

full_result
optional

Whether or not to show all results

Validations:

  • Must be one of: true, false, 1, 0.

sort_by
optional

Field to sort the results on

Validations:

  • String

sort_order
optional

How to order the sorted results (e.g. ASC for ascending)

Validations:

  • String

organization_id
required

Organization ID

Validations:

  • Must be a number.

host_id
optional

id of a host

Validations:

  • String

activation_key_id
optional

Activation key ID

Validations:

  • String

name
optional

name of the subscription

Validations:

  • String

available_for
optional

Object to show subscriptions available for, either 'host' or 'activation_key'

Validations:

  • String

match_host
optional

Ignore subscriptions that are unavailable to the specified host

Validations:

  • Must be one of: true, false, 1, 0.

match_installed
optional

Return subscriptions that match installed products of the specified host

Validations:

  • Must be one of: true, false, 1, 0.

no_overlap
optional

Return subscriptions which do not overlap with a currently-attached subscription

Validations:

  • Must be one of: true, false, 1, 0.