Query Product Lines by Bank Identification Numbers
Introduction
This API returns product line summary information matching the given bank identification numbers.
Method | Service Name | Service Type |
---|---|---|
GET | productManagement/v1/productLines | Synchronous |
- Post-Productuion URI:
https://api.certification.blackhawknetwork.com/productManagement/v1/productLines?bins={bin1};{bin2};{bin3}
- Production URI:
https://api.blackhawknetwork.com/productManagement/v1/productLines?bins={bin1};{bin2};{bin3}
Request Header Attributes
Note that all three of the header attributes are optional; however, if you want idempotency support then you should specify all three on every request.
Parameter | Description | Type | Required |
---|---|---|---|
requestorId | A value defined by the client application that can be used to uniquely identify that client application. If the client application does not specify a value, a globally unique identifier will be filled in automatically. | String | N |
requestId | A value defined by the client application that can be used to uniquely identify that specific request from the client. This value should be set if the client application wants to take advantage of an idempotent operation on a service. | String | N |
previousAttempts | The number of times this same request has been attempted unsuccessfully before. A value that is greater than zero will cause the service to view this request as a retry attempt and it will be treated idempotently. | Integer | N |
In our example we will be sending the following values in the header:
Content-Type: application/json
requestorId: 1234
requestId: 2019-06-12T15:35:28-0500
previousAttempts: 0
Request Elements
Since this is a get request the request elements need to be sent in the URI itself. https://api.blackhawknetwork.com/productManagement/v1/productLines?bins={bin1};{bin2};{bin3}
The following parameters are available:
Parameter | Description | Type | Required |
---|---|---|---|
bins | Bank identification numbers for which to search. | String | Y |
exactMatch | Flag to exactly match the provided supported features. | Boolean | N |
caseSensitive | Flag to exactly match the case of the supported features. | Boolean | N |
first | The index of the first entity in this cursor view of the list. The default first index is zero referring to the first entity in the full list. | String | N |
maximum | The maximum number of entities to be shown in this cursor view of the list. | String | N |
sortKey | The name of the attribute that should be used for ordering the results. If this value is not provided, then there is no explicit sorting of the results. Only attributes in product line summary can be used for for ordering the results. | String | N |
ascending | Whether or not the results are sorted in ascending order. The valid values are true or false. | String | N |
Response Elements
The following elements are returned in the response.
Name | Description | Type |
---|---|---|
productLineSummaryList | List of matching product line summary entities. | List |
total | Total count returned from the query. | Integer |
parameters | The Request Elements specified in the request or their default values if none specified | List |
Product Line Summary
Name | Description | Type | Max Length | Mandatory |
---|---|---|---|---|
entityId | A reference to the URI for the product line. | URI | 255 | N |
brandName | The name of the brand. | String | 255 | Y |
brandLogoImage | The URI of the logo image of the brand. | String | 255 | N |
productLineName | Name of the product line. | String | Y | |
brandId | ID of the brand. | String | 26 | N |
productLineStatus | The status of the product line. The possible values are in the Product Line Status enumeration. | Enum | N | |
accountType | The account type of the product line. The possible values are in the Account Type enumeration. | Enum | N | |
paymentNetworkType | The payment network type of the product line. The possible values are in the Payment Network Type enumeration. | Enum | N | |
startDate | The date from which the product line becomes active. | Date | Y | |
endDate | The date at which the product line becomes inactive. | Date | N | |
locale | The two-character ISO 639-1 language code followed by the two-character country code, separated by an underscore, e.g., en_US. | Locale | 5 | N |
Product Line Status
Enum Value | Description |
---|---|
DRAFT | New product line in draft mode. |
ACTIVATED | Product line in active mode. |
SUSPENDED | Product line in suspended mode. |
Account Type
Enum Value | Description |
---|---|
CREDIT_CARD | Credit card |
GIFT_CARD | Gift card |
LOYALTY_CARD | Loyalty card |
PHONE_CARD | Phone card |
Payment Network Type
Enum Value | Description |
---|---|
VISA | Visa |
MASTERCARD | Master Card |
DISCOVER | Discover |
AMEX | American Express |
Sample Request and Response
Click on the tabs below to see a sample GET request and the sample response.
GET /productManagement/v1/productLines?bin=6006492619 HTTP/1.1
requestorID: ZPZB7DDS20PNHALMZCBX14RVCM
Content-Type: application/json; charset=UTF-8
Accept: application/json; charset=UTF-8
Host: api.blackhawknetwork.com
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.2 (java 1.5)
HTTP/1.1 200 OK
Date: Fri, 06 Jul 2012 22:31:51 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 2027
Keep-Alive: timeout=5, max=100
Connection: Keep-Alive
{
"results":[
{
"entityId":"https://api.blackhawknetwork.com/productManagement/v1/productLine/XX4YSJA1HF2ZC8505TL3DLM5W4",
"productLineName": "American Express",
"brandName":"American Express",
"brandCode": "EXPR",
"brandId":"ZW7TSF5KTFJ0C1SVRTS9AP87HS",
"brandLogoImage":"https://giftcardmall.com/gcmimages/manufacturer/icon/GOWALLET_METADATA/343V1910.0.PNG",
"productLineStatus":"ACTIVATED",
"productLineType" : "GIFT_CARD",
"paymentNetworkType": "AMEX",
"startDate":"2014-06-27T19:14:45.000+0000",
"endDate":"2014-06-27T19:14:45.000+0000"
}
],
"total":1
}
Updated 7 months ago