Alexa Skills Kit    >    Get Deeper       Request APIs

Request APIs

Alexa sends requests to your application logic using a JSON payload. The requests you receive from Alexa and the format of the requests depends on the type of skill that you build. You can use the resources below to understand the interfaces, or APIs, that you use with each skill type. 

Request APIs Feature
On this page:

How Requests Work

Receive Requests

Alexa communicates with your application logic via a request-response mechanism using HTTP over SSL/TLS. When a user interacts with an Alexa skill, your service receives a POST request containing a JSON body. The request body contains the parameters necessary for your service to perform its logic and generate a JSON-formatted response.

Capability Interfaces

Each skill type provides a capability interface, or API, that defines the structure of requests and responses that your application logic will use. See below for additional details.

ASK SDKs

If you build a custom skill and host your application logic in AWS Lambda, you can use the Alexa Skills Kit SDKs to reduce the amount of code you must write to receive and respond to requests.

Save Money with AWS Promotional Credits for Alexa

Did you know you know Alexa developers can build and host an application logic for most Alexa skills for free using Amazon Web Services (AWS)?

Learn More

Request APIs by Skill Type

Custom Skills

When you build a custom skill, you define how customers' spoken input maps to the requests, or intents, that your skill can handle, and the arguments for each. When a customer speaks to your skill, Alexa processes the speech for you, and sends you the intent and arguments.

Smart Home Skills

You use capability interfaces in the Smart Home Skill API to describe your devices and its capabilities. When a customer asks Alexa to control one of your supported capabilities, Alexa sends the appropriate request, or directive, to your application logic. 

Music Skills

You can use the Music Skill API to integrate your music service so that customers can play from your catalog on Alexa devices. After you upload your content catalog, Alexa will send you requests such as initiate playback and get next item.

Video Skills

You can use the Video Skill API to integrate your video skill with the Alexa service so that customers can control video devices and consume video content without invoking a specific skill. When a customer asks Alexa to play a video, Alexa will turn on a device and route users to the content they want.

Flash Briefing Skills

The Flash Briefing Skill API does not require you to receive customer requests or respond. Instead, you update you latest content with JSON or RSS and Alexa will play it when customers ask or a routine is invoked. 

Education Skills (Preview)

You can use the Education Skill API to create a skill that links an Alexa account to a student profile on your service. When a customer requests information about a student, you receive the request to your application logic along with which student it pertains to. 

line-break

Latest Feature Updates for Request APIs

                

Date Name Summary Locale Availability Links Release Type

3/26/2020

Sensitivity Tuning for Fallback Intent

Sensitivity tuning lets you tune your skill model to respond to more customer requests with the Fallback Intent

US, DE

Documentation

Generally Available

3/2/2020 Fallback Intent Available in hi-IN and pt-BR The Amazon.FallbackIntent expands to Hindi and Portugese IN, BR Documentation Generally Available
2/13/2020 Shared Slots You can now share custom slot types between your skills All Alexa Blog Generally Available

12/16/2019

Knowledge Skills (Preview)

Announcing Alexa Knowledge Skills (preview): query your organization's data without writing code or invoking a skill name

All

Alexa Blog

Preview

line-break

Content Related to Request APIs