# Amazon Alexa ## Rest [[API]] [Official Website for Lists API](https://developer.amazon.com/en-US/docs/alexa/list-skills/list-management-api-reference.html) Endpoint: `https://api.amazonalexa.com` |Operation|HTTP method and URI| |---|---| |[Create list](https://developer.amazon.com/en-US/docs/alexa/list-skills/list-management-api-reference.html#create-list)|`POST /v2/householdlists/`| |[Create list item](https://developer.amazon.com/en-US/docs/alexa/list-skills/list-management-api-reference.html#create-list-item)|`POST /v2/householdlists/{listId}/items`| |[Delete list](https://developer.amazon.com/en-US/docs/alexa/list-skills/list-management-api-reference.html#delete-list)|`DELETE /v2/householdlists/{listId}`| |[Delete list item](https://developer.amazon.com/en-US/docs/alexa/list-skills/list-management-api-reference.html#delete-list-item)|`DELETE /v2/householdlists/{listId}/items/{itemId}`| |[Get list](https://developer.amazon.com/en-US/docs/alexa/list-skills/list-management-api-reference.html#get-list)|`GET /v2/householdlists/{listId}/{status}`| |[Get list item](https://developer.amazon.com/en-US/docs/alexa/list-skills/list-management-api-reference.html#get-list-item)|`GET /v2/householdlists/{listId}/items/{itemId}`| |[Get lists metadata](https://developer.amazon.com/en-US/docs/alexa/list-skills/list-management-api-reference.html#get-list-metadata)|`GET /v2/householdlists/`| |[Update list](https://developer.amazon.com/en-US/docs/alexa/list-skills/list-management-api-reference.html#update-list)|`PUT /v2/householdlists/{listId}`| |[Update list item](https://developer.amazon.com/en-US/docs/alexa/list-skills/list-management-api-reference.html#update-list-item)|`PUT /v2/householdlists/{listId}/items/{itemId}`| #### Authorization #### Examples: Create List: ``` POST /v2/householdlists/ Host: api.amazonalexa.com Content-Type: application/json Authorization: Bearer {access token} { "name": "name of the new custom list", "state": "active" } ```