Vendor Operations

This document describes all API operations related to the vendors resource. The API's endpoint is https://api.amazonalexa.com. Each API request must have an Authorization header whose value should be the access token retrieved from Login with Amazon.

See also: Alexa Skills Kit Command Line Interface (ASK CLI) Overview

Get Vendor List

Request

GET /v1/vendors

Response

HTTP/1.1 200 OK

Body

Here is a sample response:

[
  {
    "id": "VENDORID1",
    "name": "VendorName1",
    "roles": [
      "ROLE_ADMINISTRATOR"
    ]
  },
  {
      "id": "VENDORID2",
      "name": "VendorName2",
      "roles": [
        "ROLE_DEVELOPER"
      ]
  }
]

Response object description

Field Description
vendor_id Unique identifier of vendor associated with the API caller account.
vendor_name Name of vendor.
role Role of API caller for the vendor.

Exceptions

HTTP/1.1 401 Unauthorized

HTTP/1.1 429 Too Many Requests

HTTP/1.1 500 Internal Server Error

HTTP/1.1 503 Service Unavailable