# Visa BIN Attribute Sharing Service

Search API Reference

- [Getting Started](https://developer.visa.com/capabilities/visa-bin-attribute-sharing-service/docs)
- [Authentication Method](https://developer.visa.com/capabilities/visa-bin-attribute-sharing-service/docs-authentication)
- [How to Use VBASS](https://developer.visa.com/capabilities/visa-bin-attribute-sharing-service/docs-how-to)
- [VBASS Request and Response](https://developer.visa.com/capabilities/visa-bin-attribute-sharing-service/docs-request-response-codes)
- [Frequently Asked Questions](https://developer.visa.com/capabilities/visa-bin-attribute-sharing-service/faq)
- [Error Codes](https://developer.visa.com/pages/visa-developer-error-codes)
- [Product Terms](https://developer.visa.com/capabilities/visa-bin-attribute-sharing-service/product-terms)
- [Request & Response Codes](https://developer.visa.com/capabilities/visa-bin-attribute-sharing-service/docs-request-response-codes)

## BIN File Transfer

Transfer Account/Token Range File

### BIN File Transfer v1 - Latest

Get access to a BIN Account/Token Range file in csv format

#### Request

##### Request Body schema: application/json

BIN File Transfer request payload

|     |     |
| --- | --- |
| requestData | object |
| |     |     |
| --- | --- |
| fileName<br>required | string \[ 1 .. 255 \] characters <br>Name of the file | |
| requestHeader | object |
| |     |     |
| --- | --- |
| requestMessageId<br>required | string \[ 1 .. 30 \] characters <br>A string which uniquely identifies the service request. Requesting application need to create this unique message Id |
| requestTS<br>required | string <YYYY-MM-DDThh:mm:ss.sss>  23 characters <br>Date and time at which Request is sent (up to milliseconds in GMT). Ex: 2008-09-19T00:00:00.000 | |

#### Responses

200
BinFileTransfer Response

##### Response Schema: application/json

object

400
Request Data Invalid

401
Unauthorized

500
Error Codes

##### Response Schema: application/json

|     |     |
| --- | --- |
| CDI001 | object<br>Internal service failure |
| CDI002 | object<br>XML Parsing Failure |
| CDI012 | object<br>Request header length is invalid |
| CDI052 | object<br>Client Authentication failed |
| CDI071 | object<br>Exception in Group level entitlement process |
| CDI249 | object<br>Payment Account Type validation failure |
| CDI250 | object<br>Atleast one of the required/mandatory fields is missing in the request |

post/filedeliveryservice/v1/binFileTransfer

Sandbox server

https://sandbox.api.visa.com/filedeliveryservice/v1/binFileTransfer

## Request samples

- Payload

```json
{"requestHeader": {"requestTS": "2017-02-15T22:05:00.000",
"requestMessageId": "testAnna"
},

"requestData": {"fileName": "VBASS_TR_LEVEL3_03252021_79.csv"
}
}
```

## Response samples

- 200
- 500

application/json

```json
"Sample response will contain csv file in a comma-separated format"
```