Bulk retrieve vendorsBeta

POST

/v2/vendors/bulk-retrieve

Retrieves one or more vendors of specified Vendor IDs.

Permissions:VENDOR_READ

Guide

Retrieve vendors

Try in API Explorer

Link to section

Request body

Example code

Link to section

vendor_ids

string [ ]

IDs of the Vendor objects to retrieve.

Max Length

100

Link to section

Response fields

Link to section

errors

Any errors that occurred during the request.

Link to section

responses

The set of RetrieveVendorResponse objects encapsulating successfully retrieved Vendor objects or error responses for failed attempts. The set is represented by a collection of Vendor-ID/Vendor-object or Vendor-ID/error-object pairs.

Link to section

Examples

POST /v2/vendors/bulk-retrieve

curl https://connect.squareup.com/v2/vendors/bulk-retrieve \
  -X POST \
  -H 'Square-Version: 2024-03-20' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "vendor_ids": [
      "INV_V_JDKYHBWT1D4F8MFH63DBMEN8Y4"
    ]
  }'

Response JSON

{
  "errors": [],
  "vendors": {
    "INV_V_JDKYHBWT1D4F8MFH63DBMEN8Y4": {
      "vendor": {
        "id": "INV_V_JDKYHBWT1D4F8MFH63DBMEN8Y4",
        "created_at": "2022-03-16T10:21:54.859Z",
        "updated_at": "2022-03-16T10:21:54.859Z",
        "name": "Joe's Fresh Seafood",
        "address": {
          "address_line_1": "505 Electric Ave",
          "address_line_2": "Suite 600",
          "locality": "New York",
          "administrative_district_level_1": "NY",
          "postal_code": "10003",
          "country": "US"
        },
        "contacts": [
          {
            "id": "INV_VC_FMCYHBWT1TPL8MFH52PBMEN92A",
            "name": "Joe Burrow",
            "email_address": "[email protected]",
            "phone_number": "1-212-555-4250"
          }
        ],
        "account_number": "4025391",
        "note": "a vendor",
        "version": 1,
        "status": "ACTIVE"
      }
    }
  }
}