peskybird
API reference › Your account

List your devices

GEThttps://peskybird.app/api/push/devices
Auth App token

The paired devices and the topics each receives. Put their ids in a send's `devices` to reach only some of them.

Revoked devices are left out. A send's devices takes these ids; a device still has to receive the topic.

Response 200

The devices.

  • devicesobject[]Required

    Paired devices that are not revoked.

    Fields of each item (5)
    • idstringRequired

      Use it in a send's devices to reach only this device.

    • namestringRequired

      User-visible device name, 1 to 64 chars.

      at most 64 characters
    • platformios | androidRequired

      Client platform. Closed enum.

    • statuspending | activeRequired

      pending until the device first reports its push token.

    • topicsstring[]Required

      Topics the device receives (subscribed and not muted).

Errors

401unauthorized: The Authorization header is missing, or the token is not valid or has been revoked.
403forbidden: The token may not send to this topic, or the account does not allow what was asked. details.reason says which: topic_limit, images_not_enabled or account_suspended.
429rate_limited: The account reached its daily limit, or the token sent too fast.

Every error uses the same envelope. Error format and codes