Skip to content

GraphQL Overview

Download GraphQL schema

Queries

Overview

getEntitlementByActivationId

(activationId)

Fetches an Entitlement associated to the given Activation ID

Arguments

activationId
String!,non-nullrequired

Return type

Entitlement
createdOn
String

Represents the date and time when the entitlement was created.

description
String

Human readable description of the entitlement.

entitlementId
String!,non-null

Represents a high-level entitlement entity.

shipToAddress
String

Represents the shipping address associated with the entitlement.

shipToEmail
String

Email address associated with shipment contact.

status

status could be one of the following values: ACTIVE, INACTIVE, DRAFT, DEPLOYED, OBSOLETED

updatedOn
String

Represents the date and time when the entitlement was last updated.

Query sample
query getEntitlementByActivationId($activationId: String!) {
  getEntitlementByActivationId(activationId: $activationId) {
    createdOn 
    description 
    entitlementId 
    shipToAddress 
    shipToEmail 
    status 
    updatedOn 
  }
}
Variables
{ "activationId": "Example String" }
Response sample
{ "data": { "createdOn": "Example String", "description": "Example String", "entitlementId": "Example String", "shipToAddress": "Example String", "shipToEmail": "Example String", "status": "DEPLOYED", "updatedOn": "Example String" } }

getEntitlementById

(entitlementId)

Fetches an Entitlement by its ID.

Arguments

entitlementId
String!,non-nullrequired

Return type

EntitlementDetail
accounts
[Account!]!,non-null

Represents the accounts associated with the entitlement.

attributes

Represents the custom attributes associated with the entitlement.

createdOn
String

Represents the date and time when the entitlement was created.

description
String

Human readable description of the entitlement.

entitlementId
String!,non-null

Unique identifier of the entitlement.

lineItems

List of line items associated with the entitlement.

shipToAddress
String

Represents the shipping address associated with the entitlement.

shipToEmail
String

Email address associated with shipment contact.

status

status could be one of the following values: ACTIVE, INACTIVE, DRAFT, DEPLOYED, OBSOLETED

updatedOn
String

Represents the date and time when the entitlement was last updated.

Query sample
query getEntitlementById($entitlementId: String!) {
  getEntitlementById(entitlementId: $entitlementId) {
    accounts {
      __typename
      # ...AccountFragment
    }
    attributes {
      __typename
      # ...AttributeFragment
    }
    createdOn 
    description 
    entitlementId 
    lineItems {
      __typename
      # ...LineItemDetailFragment
    }
    shipToAddress 
    shipToEmail 
    status 
    updatedOn 
  }
}
Variables
{ "entitlementId": "Example String" }
Response sample
{ "data": { "accounts": [ { "__typename": "Account" } ], "attributes": [ { "__typename": "Attribute" } ], "createdOn": "Example String", "description": "Example String", "entitlementId": "Example String", "lineItems": [ { "__typename": "LineItemDetail" } ], "shipToAddress": "Example String", "shipToEmail": "Example String", "status": "DEPLOYED", "updatedOn": "Example String" } }

getEntitlements

(...args)

Fetches a list of Entitlements based on various filters.

Arguments

accountId
String

Unique identifier for the account

accountName
String

Name of the account

contactEmail
String

Contact email associated with the entitlement

limit
Int

limit number of records per page

page
Int

page number for pagination

partNumber
String

Product Part number associated with the entitlement

product
String

Product associated with the entitlement

productVersion
String

Product version associated with the entitlement

sortBy
String

sortBy - You can sort by the following fields entitlement_id,account_name,created_on

sortOrder
String

sortOrder - You can specify either asc or desc

status
String

status - You can filter by the following statuses active, inactive, draft, deployed, obsoleted

Return type

EntitlementListResponse
entitlements

List of entitlement entities.

limit
Int

Represents limit per page for pagination.

page
Int

Represents page for pagination.

Query sample
query getEntitlements(
  $accountId: String
  $accountName: String
  $contactEmail: String
  $limit: Int
  $page: Int
  $partNumber: String
  $product: String
  $productVersion: String
  $sortBy: String
  $sortOrder: String
  $status: String
) {
  getEntitlements(
    accountId: $accountId
    accountName: $accountName
    contactEmail: $contactEmail
    limit: $limit
    page: $page
    partNumber: $partNumber
    product: $product
    productVersion: $productVersion
    sortBy: $sortBy
    sortOrder: $sortOrder
    status: $status
  ) {
    entitlements {
      __typename
      # ...EntitlementFragment
    }
    limit 
    page 
  }
}
Variables
{ "accountId": "Example String", "accountName": "Example String", "contactEmail": "Example String", "limit": 40, "page": 40, "partNumber": "Example String", "product": "Example String", "productVersion": "Example String", "sortBy": "Example String", "sortOrder": "Example String", "status": "Example String" }
Response sample
{ "data": { "entitlements": [ { "__typename": "Entitlement" } ], "limit": 40, "page": 40 } }

getLineItemsForEntitlement

(...args)

Given an entitlement ID, fetch the line items associated with it.

Arguments

activationId
String

Activation ID of the line item

entitlementId
String!,non-nullrequired

Entitlement ID for which line items are to be fetched

licenseModelName
String

License model name associated with the line item.

limit
Int

limit number of records per page

page
Int

page number for pagination

productName
String

Name of the product associated with the line item

startDate
String

Start date of the line item.

status
String

Status of the line item. You can filter by the following statuses active, inactive, draft, deployed, obsoleted

Return type

LineItemListResponse
limit
Int

Represents limit per page for pagination.

lineItems
[LineItem!]!,non-null

List of line item entities.

page
Int

Represents page for pagination.

Query sample
query getLineItemsForEntitlement(
  $activationId: String
  $entitlementId: String!
  $licenseModelName: String
  $limit: Int
  $page: Int
  $productName: String
  $startDate: String
  $status: String
) {
  getLineItemsForEntitlement(
    activationId: $activationId
    entitlementId: $entitlementId
    licenseModelName: $licenseModelName
    limit: $limit
    page: $page
    productName: $productName
    startDate: $startDate
    status: $status
  ) {
    limit 
    lineItems {
      __typename
      # ...LineItemFragment
    }
    page 
  }
}
Variables
{ "activationId": "Example String", "entitlementId": "Example String", "licenseModelName": "Example String", "limit": 40, "page": 40, "productName": "Example String", "startDate": "Example String", "status": "Example String" }
Response sample
{ "data": { "limit": 40, "lineItems": [ { "__typename": "LineItem" } ], "page": 40 } }

Mutations

Overview

Objects

Overview

Enums

Overview

Inputs

Overview