{"_id":"59df6a593b756800107b20ac","category":{"_id":"59df6a523b756800107b2028","version":"59df6a523b756800107b201e","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-11-23T18:27:07.992Z","from_sync":false,"order":9,"slug":"marketplace","title":"Marketplace"},"user":"560d5913af97231900938124","parentDoc":null,"project":"57336fd5a6a9c40e00e13a0b","version":{"_id":"59df6a523b756800107b201e","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-10-12T13:12:50.128Z","releaseDate":"2017-10-12T13:12:50.128Z","categories":["59df6a523b756800107b201f","59df6a523b756800107b2020","59df6a523b756800107b2021","59df6a523b756800107b2022","59df6a523b756800107b2023","59df6a523b756800107b2024","59df6a523b756800107b2025","59df6a523b756800107b2026","59df6a523b756800107b2027","59df6a523b756800107b2028","59df6a523b756800107b2029","59df6a523b756800107b202a","59df6a523b756800107b202b","59df6a523b756800107b202c","59df6a523b756800107b202d","59df6a523b756800107b202e"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.23 Release","version_clean":"8976.0.0-XML","version":"8976-XML"},"__v":4,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-11-23T18:31:09.832Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"method":"get","results":{"codes":[]},"settings":"","examples":{"codes":[]},"auth":"optional","params":[{"_id":"5a1c35c8acac6b001e666978","ref":"","in":"query","required":false,"desc":"Vendor ID. The response will get the page of results after the specified ID (exclusive).","default":"","type":"int","name":"after"},{"_id":"5a1c35c8acac6b001e666977","ref":"","in":"query","required":false,"desc":"Vendor ID. The response will get the page of results before the specified ID (exclusive).","default":"","type":"int","name":"before"},{"_id":"5a1c35c8acac6b001e666976","ref":"","in":"query","required":false,"desc":"Indicates whether the number of total results appears in the response.","default":"false","type":"boolean","name":"gettotal"},{"_id":"5a1c35c8acac6b001e666975","ref":"","in":"query","required":false,"desc":"Sets the maximum number of results to return (i.e. page size).","default":"10","type":"int","name":"pagesize"}],"url":"/vendors"},"isReference":false,"order":4,"body":"[block:html]\n{\n  \"html\": \"<script>\\n  // hide body textbox of API Explorer\\n $(document).ready(function() {\\n  $(\\\"textarea[placeholder='Body Content']\\\").hide();  \\n }); \\n</script>\"\n}\n[/block]\nThe Retrieve All Vendors request retrieves all your vendors and their saved details.\n\n<a class=\"btn btn-success\" href=\"#section-api-explorer\" role=\"button\">Try it in the API Explorer</a>\n\n###Request Content\nNo content is required in the request body. See above for the supported query parameters\n\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 Example\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/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\",\n      \"language\": \"curl\",\n      \"name\": \"Retrieve All Vendors Request\"\n    }\n  ]\n}\n[/block]\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n### Response Example\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<vendors xmlns=\\\"http://ws.plimus.com\\\">\\n  <total-results>148</total-results>\\n  <last-page>false</last-page>\\n  <vendor>\\n    <vendor-id>10396912</vendor-id>\\n    <email>name:::at:::yahoo.com</email>\\n    <name>MarketVendor</name>\\n    <first-name>Vita</first-name>\\n    <last-name>Test</last-name>\\n    <address>Medinat</address>\\n    <city>Tel Aviv</city>\\n    <zip>123456</zip>\\n    <country>il</country>\\n    <phone>1800808080</phone>\\n    <default-payout-currency>USD</default-payout-currency>\\n    <frequency>DAILY</frequency>\\n    <delay>3</delay>\\n    <vendor-principal>\\n      <first-name>Brad</first-name>\\n      <last-name>Pitt</last-name>\\n      <address>Hollywood</address>\\n      <city>LA</city>\\n      <zip>4234234</zip>\\n      <country>US</country>\\n      <dob>04-10-1983</dob>\\n      <personal-identification-number>1234</personal-identification-number>\\n      <driver-license-number>561196411</driver-license-number>\\n      <email>test@test.com</email>\\n    </vendor-principal>\\n    <payout-info>\\n      <payout-type>ACH</payout-type>\\n      <base-currency>USD</base-currency>\\n      <name-on-account>Kuki</name-on-account>\\n      <bank-account-class>CORPORATE</bank-account-class>\\n      <bank-account-type>CHECKING</bank-account-type>\\n      <bank-name>Leumi</bank-name>\\n      <bank-id>12445</bank-id>\\n      <country>ir</country>\\n      <city>Teheran</city>\\n      <address>Tahrir</address>\\n      <zip>665433</zip>\\n      <bank-account-id>36628822</bank-account-id>\\n      <intermediary-bank-info/>\\n    </payout-info>\\n    <vendor-agreement>\\n      <commission-percent>30</commission-percent>\\n      <account-status>ACTIVE</account-status>\\n      <recurring-commission>Y</recurring-commission>\\n    </vendor-agreement>\\n    <verification>\\n      <payout-status>Approved</payout-status>\\n      <processing-status>Active</processing-status>\\n    </verification>\\n  </vendor>\\n  <vendor>\\n    <vendor-id>513275</vendor-id>\\n    <email>joe@yahoo.com</email>\\n    <name>MarketVendor</name>\\n    <first-name>Vita</first-name>\\n    <last-name>Test</last-name>\\n    <address>Medinat</address>\\n    <city>Tel Aviv</city>\\n    <zip>123456</zip>\\n    <country>il</country>\\n    <phone>1800808080</phone>\\n    <default-payout-currency>USD</default-payout-currency>\\n    <frequency>DAILY</frequency>\\n    <delay>3</delay>\\n    <vendor-principal>\\n      <first-name>Tom</first-name>\\n      <last-name>Jones</last-name>\\n      <address>Hollywood</address>\\n      <city>LA</city>\\n      <zip>4234234</zip>\\n      <country>US</country>\\n      <dob>04-10-1983</dob>\\n      <personal-identification-number>1234</personal-identification-number>\\n      <driver-license-number>561196411</driver-license-number>\\n      <email>test@test.com</email>\\n    </vendor-principal>\\n    <payout-info>\\n      <payout-type>ACH</payout-type>\\n      <base-currency>USD</base-currency>\\n      <name-on-account>Kuki</name-on-account>\\n      <bank-account-class>INTERNATIONAL</bank-account-class>\\n      <bank-account-type>CHECKING</bank-account-type>\\n      <bank-name>Leumi</bank-name>\\n      <bank-id>12445</bank-id>\\n      <country>ir</country>\\n      <city>Teheran</city>\\n      <address>Tahrir</address>\\n      <zip>665433</zip>\\n      <bank-account-id>36628822</bank-account-id>\\n      <intermediary-bank-info/>\\n    </payout-info>\\n    <vendor-agreement>\\n      <commission-percent>30</commission-percent>\\n      <account-status>ACTIVE</account-status>\\n      <recurring-commission>Y</recurring-commission>\\n    </vendor-agreement>\\n    <verification>\\n      <payout-status>Approved</payout-status>\\n      <processing-status>Active</processing-status>\\n    </verification>\\n  </vendor>\\n</vendors>\\n\",\n      \"language\": \"xml\",\n      \"name\": \"Retrieve All Vendors Response\"\n    }\n  ]\n}\n[/block]\n##Example Descriptions\n\n###Retrieve Vendors\nThe example above shows how to retrieve all vendors in your account.\n\n<hr>\n\n##API Explorer\nTo test out a Retrieve All Vendors call, optionally enter any values for the query parameters, and click the **Try it!** button below.","excerpt":"","slug":"retrieve-all-vendors","type":"get","title":"Retrieve All Vendors"}

getRetrieve All Vendors


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

after:
integer
Vendor ID. The response will get the page of results after the specified ID (exclusive).
before:
integer
Vendor ID. The response will get the page of results before the specified ID (exclusive).
gettotal:
booleanfalse
Indicates whether the number of total results appears in the response.
pagesize:
integer10
Sets the maximum number of results to return (i.e. page size).

Documentation

The Retrieve All Vendors request retrieves all your vendors and their saved details.

Try it in the API Explorer

Request Content

No content is required in the request body. See above for the supported query parameters

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the vendors object.


Examples

Request Example

curl -v -X GET https://sandbox.bluesnap.com/services/2/vendors?gettotal=true
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='

Back to Top


Response Example

<vendors xmlns="http://ws.plimus.com">
  <total-results>148</total-results>
  <last-page>false</last-page>
  <vendor>
    <vendor-id>10396912</vendor-id>
    <email>name@yahoo.com</email>
    <name>MarketVendor</name>
    <first-name>Vita</first-name>
    <last-name>Test</last-name>
    <address>Medinat</address>
    <city>Tel Aviv</city>
    <zip>123456</zip>
    <country>il</country>
    <phone>1800808080</phone>
    <default-payout-currency>USD</default-payout-currency>
    <frequency>DAILY</frequency>
    <delay>3</delay>
    <vendor-principal>
      <first-name>Brad</first-name>
      <last-name>Pitt</last-name>
      <address>Hollywood</address>
      <city>LA</city>
      <zip>4234234</zip>
      <country>US</country>
      <dob>04-10-1983</dob>
      <personal-identification-number>1234</personal-identification-number>
      <driver-license-number>561196411</driver-license-number>
      <email>test@test.com</email>
    </vendor-principal>
    <payout-info>
      <payout-type>ACH</payout-type>
      <base-currency>USD</base-currency>
      <name-on-account>Kuki</name-on-account>
      <bank-account-class>CORPORATE</bank-account-class>
      <bank-account-type>CHECKING</bank-account-type>
      <bank-name>Leumi</bank-name>
      <bank-id>12445</bank-id>
      <country>ir</country>
      <city>Teheran</city>
      <address>Tahrir</address>
      <zip>665433</zip>
      <bank-account-id>36628822</bank-account-id>
      <intermediary-bank-info/>
    </payout-info>
    <vendor-agreement>
      <commission-percent>30</commission-percent>
      <account-status>ACTIVE</account-status>
      <recurring-commission>Y</recurring-commission>
    </vendor-agreement>
    <verification>
      <payout-status>Approved</payout-status>
      <processing-status>Active</processing-status>
    </verification>
  </vendor>
  <vendor>
    <vendor-id>513275</vendor-id>
    <email>joe@yahoo.com</email>
    <name>MarketVendor</name>
    <first-name>Vita</first-name>
    <last-name>Test</last-name>
    <address>Medinat</address>
    <city>Tel Aviv</city>
    <zip>123456</zip>
    <country>il</country>
    <phone>1800808080</phone>
    <default-payout-currency>USD</default-payout-currency>
    <frequency>DAILY</frequency>
    <delay>3</delay>
    <vendor-principal>
      <first-name>Tom</first-name>
      <last-name>Jones</last-name>
      <address>Hollywood</address>
      <city>LA</city>
      <zip>4234234</zip>
      <country>US</country>
      <dob>04-10-1983</dob>
      <personal-identification-number>1234</personal-identification-number>
      <driver-license-number>561196411</driver-license-number>
      <email>test@test.com</email>
    </vendor-principal>
    <payout-info>
      <payout-type>ACH</payout-type>
      <base-currency>USD</base-currency>
      <name-on-account>Kuki</name-on-account>
      <bank-account-class>INTERNATIONAL</bank-account-class>
      <bank-account-type>CHECKING</bank-account-type>
      <bank-name>Leumi</bank-name>
      <bank-id>12445</bank-id>
      <country>ir</country>
      <city>Teheran</city>
      <address>Tahrir</address>
      <zip>665433</zip>
      <bank-account-id>36628822</bank-account-id>
      <intermediary-bank-info/>
    </payout-info>
    <vendor-agreement>
      <commission-percent>30</commission-percent>
      <account-status>ACTIVE</account-status>
      <recurring-commission>Y</recurring-commission>
    </vendor-agreement>
    <verification>
      <payout-status>Approved</payout-status>
      <processing-status>Active</processing-status>
    </verification>
  </vendor>
</vendors>

Example Descriptions

Retrieve Vendors

The example above shows how to retrieve all vendors in your account.


API Explorer

To test out a Retrieve All Vendors call, optionally enter any values for the query parameters, and click the Try it! button below.


User Information

Try It Out


get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}