Get seat details by subscription ID
Added by IBM contributorElizabeth Bowling | Edited by Vidyashri Hegde on March 17, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Retrieves the details of the specified seat for a specified subscription.

The API caller must have the VSR or CustomerAdministrator role to run the API.

This operation first checks for the existence of the subscription with specified subscription_id, then checks whether the seat specified by seat_id exists. Finally it validates that the seat specified by seat_id belongs to subscription specified by subscription_id before returning the seat details.

Input
Method URI Description
GET resource/subscription/<subscription_id>/seat/<seat_id> Provide both the subscription ID and the seat ID.
Name Type Optional Description
subscription_id
number Yes The ID of the subscription that owns the seat.
seat_id
number Yes The ID of the seat.
Output
Code Description
400
Input format error. Returned for any of the following reasons:
- Seat does not belong to the given Subscription
Returned when the specified seat does not belong to the specified subscription.
- Subscription Id should be a valid integer.
The subscription_id passed in the URI is less than 0
- Seat Id should be a valid integer.
The seat_id passed in the URI is less than or equal to 0.
- Invalid URI.
The URI probably contains non-numeric values for subscription_id and/or seat_id.
404
Data not found. Returned for either of the following reasons:
- Subscription with ID subscription_id not found.
The subscription for the specified subscription_id does not exist (or was deleted).
- Seat with specified ID does not exist.
The specified seat_id does not exist (or was deleted) for the specified subscription_id.
Examples
The request for details on seat 110286 belonging to subscription 59670results in the output that follows. Note the seat_id '110286' and subscription_id '59670' appear in the response JSON.
GET resource/subscription/59670/seat/110286

Response returned by the server
{
  "Seat": {
    "VendorId":10,
    "SubscriberId":20139011,
    "TermsOfUseId":0,
    "SeatServiceProductAttributeSet": [

    ],
    "ProvisioningWorkflowId":0,
    "Created":"08\/22\/2014 05:40:37",
    "Modified":"08\/22\/2014 05:40:37",
    "Oid":110286,
    "HasAcceptedTermsOfUse":true,
    "SeatState":"ASSIGNED",
    "EntitlementQuantityAllocated":7,
    "Owner":20137924,
    "OptimisticLock":0,
    "SubscriptionId":59670,
    "Version":4,
    "WorkflowIdList": [

    ],
    "Deleted":false,
    "Id":110286
  }
}