{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"optional","method":"get","results":{"codes":[]},"settings":"57ee593a21ceb20e0061959e","examples":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Retrieve All Vendors","type":"endpoint","slug":"retrieve-all-vendors","excerpt":"","body":"##Definition\nhttps<span>://sandbox.bluesnap.com/services/2/vendors?{parameters}</span>\n\n##Documentation\nThe Retrieve All Vendors request retrieves all your vendors and their saved details.\n\n\n###Request Content\nEnter any of the query parameters below into the request URL. For example:\n`services/2/vendors?pagesize=20&after=34567&gettotal=true`\n\n**Query Parameters**\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Parameter Name\",\n \"h-1\": \"Description\",\n \"h-2\": \"Example\",\n \"0-0\": \"`after`\",\n \"0-1\": \"Vendor ID. The response will get the page of results after the specified ID (exclusive).\",\n \"0-2\": \"`after=34567`\",\n \"1-0\": \"`before`\",\n \"1-1\": \"Vendor ID. The response will get the page of results before the specified ID (exclusive).\",\n \"1-2\": \"`before=12345`\",\n \"2-0\": \"`gettotal`\",\n \"2-1\": \"**true** = Include the number of total results in the response\",\n \"2-2\": \"`gettotal=true`\",\n \"3-0\": \"`pagesize`\",\n \"3-1\": \"Positive integer. Sets the maximum number of results to return (i.e. page size).\\nDefault is **10** if not set.\\nMaximum is **500**.\",\n \"3-2\": \"`pagesize=20`\"\n },\n \"cols\": 3,\n \"rows\": 4\n}\n[/block]\n###Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response contains the [vendors](doc:vendors) object.\n\n<hr>\n\n##Examples\n\n###Request Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/vendors?gettotal=true\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\",\n \"language\": \"curl\",\n \"name\": \"Retrieve All Vendors Request\"\n }\n ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"totalResults\\\": 47, \\n \\\"lastPage\\\": false,\\n \\\"vendor\\\": [\\n {\\n \\\"vendorId\\\": 514151,\\n \\\"email\\\": \\\"vendor@bluesnap.com\\\",\\n \\\"name\\\": \\\"Important Vendor\\\",\\n \\\"firstName\\\": \\\"Joe\\\",\\n \\\"lastName\\\": \\\"Smith\\\",\\n \\\"address\\\": \\\"123 Main Street\\\",\\n \\\"city\\\": \\\"Juneau\\\",\\n \\\"zip\\\": \\\"4640802\\\",\\n \\\"country\\\": \\\"us\\\",\\n \\\"phone\\\": \\\"0549766778\\\",\\n \\\"state\\\": \\\"MA\\\",\\n \\\"defaultPayoutCurrency\\\": \\\"USD\\\",\\n \\\"frequency\\\": \\\"DAILY\\\",\\n \\\"delay\\\": 3,\\n \\\"vendorPrincipal\\\": {\\n \\\"firstName\\\": \\\"Joe\\\",\\n \\\"lastName\\\": \\\"Smith\\\",\\n \\\"address\\\": \\\"123 Main Street\\\",\\n \\\"city\\\": \\\"Juneau\\\",\\n \\\"zip\\\": \\\"12345\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"dob\\\": \\\"28-09-9999\\\",\\n \\\"personalIdentificationNumber\\\": 1234,\\n \\t\\\"driverLicenseNumber\\\": \\\"561196411\\\",\\n \\\"email\\\": \\\"principal.name@vendor.com\\\"\\n },\\n \\\"payoutInfo\\\": [\\n {\\n \\\"payoutType\\\": \\\"ACH\\\",\\n \\\"baseCurrency\\\": \\\"USD\\\",\\n \\\"nameOnAccount\\\": \\\"vendor\\\",\\n \\\"bankAccountClass\\\": \\\"PERSONAL\\\",\\n \\\"bankAccountType\\\": \\\"CHECKING\\\",\\n \\\"bankName\\\": \\\"Leumi\\\",\\n \\\"bankId\\\": \\\"12445\\\",\\n \\\"country\\\": \\\"us\\\",\\n \\\"city\\\": \\\"Juneau\\\",\\n \\\"address\\\": \\\"1 bank address\\\",\\n \\\"state\\\": \\\"MA\\\",\\n \\\"zip\\\": \\\"12345\\\",\\n \\\"bankAccountId\\\": \\\"36628822\\\",\\n \\\"intermediaryBankInfo\\\": {}\\n }\\n ],\\n \\\"vendorAgreement\\\": {\\n \\\"commissionPercent\\\": 30,\\n \\\"accountStatus\\\": \\\"ACTIVE\\\",\\n \\\"recurringCommission\\\": \\\"Y\\\"\\n }, \\n \\\"verification\\\": {\\n \\\"payoutStatus\\\": \\\"Approved\\\",\\n \\\"processingStatus\\\": \\\"Active\\\",\\n }\\n },\\n {\\n \\\"vendorId\\\": 514147,\\n \\\"email\\\": \\\"vendor@bluesnap.com\\\",\\n \\\"name\\\": \\\"Important Vendor\\\",\\n \\\"firstName\\\": \\\"Joe\\\",\\n \\\"lastName\\\": \\\"Smith\\\",\\n \\\"address\\\": \\\"123 Main Street\\\",\\n \\\"city\\\": \\\"Juneau\\\",\\n \\\"zip\\\": \\\"4640802\\\",\\n \\\"country\\\": \\\"us\\\",\\n \\\"phone\\\": \\\"0549766778\\\",\\n \\\"state\\\": \\\"MA\\\",\\n \\\"defaultPayoutCurrency\\\": \\\"USD\\\",\\n \\\"frequency\\\": \\\"DAILY\\\",\\n \\\"delay\\\": 3,\\n \\\"vendorPrincipal\\\": {\\n \\\"firstName\\\": \\\"Joe\\\",\\n \\\"lastName\\\": \\\"Smith\\\",\\n \\\"address\\\": \\\"123 Main Street\\\",\\n \\\"city\\\": \\\"Juneau\\\",\\n \\\"zip\\\": \\\"12345\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"dob\\\": \\\"28-09-9999\\\",\\n \\\"personalIdentificationNumber\\\": 1234,\\n \\t\\\"driverLicenseNumber\\\": \\\"561196411\\\",\\n \\\"email\\\": \\\"principal.name@vendor.com\\\"\\n },\\n \\\"payoutInfo\\\": [\\n {\\n \\\"payoutType\\\": \\\"ACH\\\",\\n \\\"baseCurrency\\\": \\\"USD\\\",\\n \\\"nameOnAccount\\\": \\\"vendor\\\",\\n \\\"bankAccountClass\\\": \\\"PERSONAL\\\",\\n \\\"bankAccountType\\\": \\\"CHECKING\\\",\\n \\\"bankName\\\": \\\"Leumi\\\",\\n \\\"bankId\\\": \\\"12445\\\",\\n \\\"country\\\": \\\"us\\\",\\n \\\"city\\\": \\\"Juneau\\\",\\n \\\"address\\\": \\\"1 bank address\\\",\\n \\\"state\\\": \\\"MA\\\",\\n \\\"zip\\\": \\\"12345\\\",\\n \\\"bankAccountId\\\": \\\"36628822\\\",\\n \\\"intermediaryBankInfo\\\": {}\\n }\\n ],\\n \\\"vendorAgreement\\\": {\\n \\\"commissionPercent\\\": 30,\\n \\\"accountStatus\\\": \\\"ACTIVE\\\",\\n \\\"recurringCommission\\\": \\\"Y\\\"\\n }, \\n \\\"verification\\\": {\\n \\\"payoutStatus\\\": \\\"Approved\\\",\\n \\\"processingStatus\\\": \\\"Active\\\",\\n } \\n }\\n ]\\n}\",\n \"language\": \"json\",\n \"name\": \"Retrieve All Vendors Response\"\n }\n ]\n}\n[/block]\n<br>\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>","updates":[],"order":4,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ed0377101fdb400214ded79","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Marketplace","slug":"marketplace","order":10,"from_sync":false,"reference":false,"_id":"5ed0377101fdb400214ded08","version":"5ed0377101fdb400214dedaa","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2016-11-23T19:23:42.327Z","__v":0},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.34.0 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ed0377101fdb400214ded00","5ed0377101fdb400214ded01","5ed0377101fdb400214ded02","5ed0377101fdb400214ded03","5ed0377101fdb400214ded04","5ed0377101fdb400214ded05","5ed0377101fdb400214ded06","5ed0377101fdb400214ded07","5ed0377101fdb400214ded08","5ed0377101fdb400214ded09","5ed0377101fdb400214ded0a","5ed0377101fdb400214ded0b","5ed0377101fdb400214ded0c","5ed0377101fdb400214ded0d","5ed0377101fdb400214ded0e","5ed0377101fdb400214ded0f","5ed0377101fdb400214ded10"],"_id":"5ed0377101fdb400214dedaa","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5e5d3aa2dc4d35003d784d9d","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"createdAt":"2016-11-23T19:25:37.026Z","githubsync":"","__v":0}getRetrieve All Vendors
Definition
https://sandbox.bluesnap.com/services/2/vendors?{parameters}
Documentation
The Retrieve All Vendors request retrieves all your vendors and their saved details.
Request Content
Enter any of the query parameters below into the request URL. For example:services/2/vendors?pagesize=20&after=34567&gettotal=true
Query Parameters
Parameter Name
Description
Example
after
Vendor ID. The response will get the page of results after the specified ID (exclusive).
after=34567
before
Vendor ID. The response will get the page of results before the specified ID (exclusive).
before=12345
gettotal
true = Include the number of total results in the response
gettotal=true
pagesize
Positive integer. Sets the maximum number of results to return (i.e. page size).
Default is 10 if not set.
Maximum is 500.
pagesize=20
Response Details
If successful, the response HTTP status code is 200 OK.
The response contains the vendors object.
Examples
Request Examples
curl -v -X GET https://sandbox.bluesnap.com/services/2/vendors?gettotal=true
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='{
"totalResults": 47,
"lastPage": false,
"vendor": [
{
"vendorId": 514151,
"email": "vendor@bluesnap.com",
"name": "Important Vendor",
"firstName": "Joe",
"lastName": "Smith",
"address": "123 Main Street",
"city": "Juneau",
"zip": "4640802",
"country": "us",
"phone": "0549766778",
"state": "MA",
"defaultPayoutCurrency": "USD",
"frequency": "DAILY",
"delay": 3,
"vendorPrincipal": {
"firstName": "Joe",
"lastName": "Smith",
"address": "123 Main Street",
"city": "Juneau",
"zip": "12345",
"country": "US",
"dob": "28-09-9999",
"personalIdentificationNumber": 1234,
"driverLicenseNumber": "561196411",
"email": "principal.name@vendor.com"
},
"payoutInfo": [
{
"payoutType": "ACH",
"baseCurrency": "USD",
"nameOnAccount": "vendor",
"bankAccountClass": "PERSONAL",
"bankAccountType": "CHECKING",
"bankName": "Leumi",
"bankId": "12445",
"country": "us",
"city": "Juneau",
"address": "1 bank address",
"state": "MA",
"zip": "12345",
"bankAccountId": "36628822",
"intermediaryBankInfo": {}
}
],
"vendorAgreement": {
"commissionPercent": 30,
"accountStatus": "ACTIVE",
"recurringCommission": "Y"
},
"verification": {
"payoutStatus": "Approved",
"processingStatus": "Active",
}
},
{
"vendorId": 514147,
"email": "vendor@bluesnap.com",
"name": "Important Vendor",
"firstName": "Joe",
"lastName": "Smith",
"address": "123 Main Street",
"city": "Juneau",
"zip": "4640802",
"country": "us",
"phone": "0549766778",
"state": "MA",
"defaultPayoutCurrency": "USD",
"frequency": "DAILY",
"delay": 3,
"vendorPrincipal": {
"firstName": "Joe",
"lastName": "Smith",
"address": "123 Main Street",
"city": "Juneau",
"zip": "12345",
"country": "US",
"dob": "28-09-9999",
"personalIdentificationNumber": 1234,
"driverLicenseNumber": "561196411",
"email": "principal.name@vendor.com"
},
"payoutInfo": [
{
"payoutType": "ACH",
"baseCurrency": "USD",
"nameOnAccount": "vendor",
"bankAccountClass": "PERSONAL",
"bankAccountType": "CHECKING",
"bankName": "Leumi",
"bankId": "12445",
"country": "us",
"city": "Juneau",
"address": "1 bank address",
"state": "MA",
"zip": "12345",
"bankAccountId": "36628822",
"intermediaryBankInfo": {}
}
],
"vendorAgreement": {
"commissionPercent": 30,
"accountStatus": "ACTIVE",
"recurringCommission": "Y"
},
"verification": {
"payoutStatus": "Approved",
"processingStatus": "Active",
}
}
]
}
