Vendor Management REST API Reference v1

Note: Submit your skill and see it come to life.

Use the Vendor Management REST API to get information about a vendor.

API endpoint

The endpoint of the Vendor Management API is https://api.amazonalexa.com.

Authentication

Each API request must have an authorization header whose value is the access token retrieved from Login with Amazon (LWA). For details, see Get an Access Token for SMAPI.

Operations

The Vendor Management API includes the following operations.

Operation	HTTP method and URI
Get vendor list	`GET /v1/vendors`

Get vendor list

Get the list of vendor information associated with the access token.

Request

To get the vendor list, you make a GET request to the vendors resource.

Request path and header example

Copied to clipboard.

GET /v1/vendors
Host: api.amazonalexa.com
Content-Type: application/json
Authorization: Bearer {access token}

Request path and header parameters

Parameter	Located in	Description	Type	Required
`access token`	Header	LWA token.	String	Yes

Request body example

The request has no body.

Request body properties

The request has no body.

Response

A successful response returns HTTP 200 OK, along with the vendor information. On error, the response returns the appropriate HTTP status code and includes a response body with an error code and human readable message.

Response body example

The following example shows a response.

{
    "vendors": [{
            "id": "vendor.id.1",
            "name": "vendor.name.1",
            "roles": [
                "ROLE_ADMINISTRATOR"
            ]
        },
        {
            "id": "vendor.id.2",
            "name": "vendor.name.2",
            "roles": [
                "ROLE_DEVELOPER"
            ]
        }
    ]
}

Response body properties

Property	Description	Type
`vendors`	List of vendors associated with the account.	Array of objects
`vendors.name`	Name of the vendor.	String
`vendors.id`	Unique identifier of vendor.	String
`vendors.roles`	Roles assigned to the account owner.	Array of strings

HTTP status codes

Status	Description
`200 OK`	Response body contains the vendor information.
`400 Bad Request`	Indicates that one or more properties in the request body are invalid. The following example shows the response body with the error and message. `{ "message": "The property is outside the allowed range.", "code": "INVALID_STRING_LENGTH" }`
`401 Unauthorized`	Request didn't include the authorization token or the token is invalid or expired. Or, the client doesn't have access to the resource.
`403 Forbidden`	Indicates that the authorization token is valid, but the requested operation isn't allowed.
`404 Not Found`	Requested resource not found.
`429 Too Many Requests`	Skill has exceeded the permitted rate limit (specified number of requests per unit of time). The skill can retry the request by using exponential back-off.
`500 Server Error`	Error occurred on the server. The skill can retry the request by using exponential back-off.
`503 Service Unavailable`	Server is down for maintenance, overloaded, or otherwise unavailable to handle the incoming request.