| Requires any of the roles: | Reseller, Merchant |
| GET | /reports/bins/{binNumbers} | Gets the data associated with one to 10 bin numbers. |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| BinNumbers | path | List<string> | Yes | The bin numbers to lookup. Must be six to 11 digit numbers. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Bin | form | long | No | The BIN/first 6 digits of the card |
| CardBrand | form | string | No | The card brand (VISA, MasterCard, American Express, etc |
| IssuingOrg | form | string | No | The organization/bank that issued the card |
| CardType | form | string | No | Typically debit or credit |
| CardCategory | form | string | No | The category indicating special types of card such as corporate, purchasing, and prepaid |
| IssuingCountry | form | string | No | The country where the card was issued |
| IssuingCountryCodeA2 | form | string | No | The A2 country code |
| IssuingCountryCodeA3 | form | string | No | The A3 country code |
| IssuingCountryNumber | form | int? | No | The issuing country number |
| IssuingPhone | form | string | No | Phone number, if available, of the issuing organization |
| IssuingWebsite | form | string | No | Web site, if available, of the issuing organization |
| PanLength | form | int? | No | The length of credit card number |
| IssuedEntity | form | string | No | Defines if the BIN is PERSONAL or COMMERCIAL |
| IsRegulated | form | bool | No | Indicates if the card is regulated |
| IsCommercial | form | bool | No | True if the IssuedEntity is equal to 'COMMERCIAL' |
To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /reports/bins/{binNumbers} HTTP/1.1
Host: syntch.simpay.net
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length
{"Bin":0,"CardBrand":"String","IssuingOrg":"String","CardType":"String","CardCategory":"String","IssuingCountry":"String","IssuingCountryCodeA2":"String","IssuingCountryCodeA3":"String","IssuingCountryNumber":0,"IssuingPhone":"String","IssuingWebsite":"String","PanLength":0,"IssuedEntity":"String","IsRegulated":false,"IsCommercial":false}