home-assistant.io/source/_components/sensor.aftership.markdown
Max Rydahl Andersen 996aba811b initial documentation for aftership sensor (#7616)
* initial documentation for aftership sensor

* ✏️ Tweaks

* Minor changes
2018-12-27 18:19:34 +01:00

1.7 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class
layout title description date sidebar comments sharing footer logo ha_category ha_release ha_iot_class
page AfterShip Sensor Instructions on how to set up AfterShip sensors within Home Assistant. 2018-11-24 01:00 true false true true aftership.png Postal Service 0.85 Cloud Polling

The aftership platform allows one to track deliveries by AfterShip, a service that supports 490+ couriers worldwide. It is free to use up to 100 tracked packages per month, after that there is a fee.

The sensor value shows the number of packages that are not in Delivered state. As attributes are the number of packages per status.

{% linkable_title Setup %}

To use this sensor, you need an AfterShip Account and set up an API Key. To set up an API Key go to AfterShip API page, and copy existing key or generate a new one.

AfterShip recently started requiring having a credit card on file even if you are only using the free plan. That does not change the functionality of the platform, just something to be aware of.

{% linkable_title Configuration %}

To enable this sensor, add the following lines to your configuration.yaml:

sensor:
  - platform: aftership
    api_key: AFTERSHIP_APIKEY

{% configuration %} name: description: The sensor name to use in the frontend. required: false default: "aftership" type: string api_key: description: The API key for AfterShip. required: true type: string {% endconfiguration %}

This component retrieves data from AfterShip public REST API, but the component is not affiliated with AfterShip.