Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI Studio
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Service page
Yandex Cloud Notification Service
Documentation
Yandex Cloud Notification Service
    • Overview
    • Getting started with mobile push notifications
    • Getting started with in-browser push notifications
    • Getting started with SMS
    • Overview
    • Mobile push notifications
    • In-browser push notifications
    • SMS
    • Quotas and limits
    • All tools
    • AWS CLI
    • AWS SDK for C++
    • AWS SDK for Go
    • AWS SDK for Java
    • AWS SDK for JavaScript
    • AWS SDK for Kotlin
    • AWS SDK for .NET
    • AWS SDK for PHP
    • AWS SDK for Python (boto3)
  • Pricing policy
    • Overview
    • Sending a request
    • Errors
      • Create
      • GetAttributes
      • SetAttributes
      • List
      • Delete
    • Publish
  • Monitoring metrics
  • Logs Cloud Logging
  • Release notes

In this article:

  • HTTP request
  • Query parameters
  • Response
  • Successful response
  • Error response
  • See also
  1. API reference
  2. Endpoint
  3. List

ListEndpointsByPlatformApplication

Written by
Yandex Cloud
Updated at April 17, 2025
  • HTTP request
    • Query parameters
  • Response
    • Successful response
    • Error response
  • See also

Gets a list of endpoints for mobile push notifications or in-browser push notifications.

HTTP requestHTTP request

POST https://notifications.yandexcloud.net/

Query parametersQuery parameters

Parameter Description
Action string
Required field.
Operation type parameter.
Value: ListEndpointsByPlatformApplication.
PlatformApplicationArn string
Required field.
Mobile push notification channel ID.
Example: arn:aws:sns::aoegtvhtp8ob********:app/GCM/test-cns-9990.
NextToken string
Token for viewing endpoint records after the first page.
ResponseFormat string
Response format.
The possible values are:
  • XML (default)
  • JSON.

ResponseResponse

Successful responseSuccessful response

If there are no errors, Cloud Notification Service returns the 200 HTTP code.

A successful response contains additional data in XML or JSON format depending on the specified ResponseFormat parameter.

Data schema:

XML
JSON
<?xml version="1.0" encoding="UTF-8"?>
<ListEndpointsByPlatformApplicationResponseXML>
    <ResponseMetadata>
  	  <RequestId>string</RequestId>
    </ResponseMetadata>
    <ListEndpointsByPlatformApplicationResult>
  	  <Endpoints>
  		  <member>
  			  <EndpointArn>string</EndpointArn>
  			  <Attributes>
  				  <entry>
  					  <key>string</key>
  					  <value>string</value>
  				  </entry>
  			  </Attributes>
  		  </member>
  	  </Endpoints>
  	  <NextToken>string</NextToken>
    </ListEndpointsByPlatformApplicationResult>
</ListEndpointsByPlatformApplicationResponseXML>
{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "ListEndpointsByPlatformApplicationResult": {
    "Endpoints": [
      {
        "EndpointARN": "string",
        "Attributes": {
          "Attribute": "string"
        }
      }
    ],
    "NextToken": "string"
  }
}

Where:

  • RequestId: Request ID.

  • EndpointArn: Mobile endpoint ID (ARN).

  • Attributes: Mobile endpoint attributes. The following attributes are supported:

    • CustomUserData: Other user data stored together with the endpoint. Cloud Notification Service does not use this data in any way.
    • Enabled: Attribute for enabling and disabling endpoint notifications, currently not supported. It always returns true.

    Note

    For data protection purposes, you can not output the Token attribute.

  • NextToken: Token for viewing endpoint records on the next page. It returns when additional records are available. If all records have been viewed, NextToken is not returned.

Error responseError response

In case of an error, Cloud Notification Service returns a message with the appropriate HTTP code.

For a list of common error codes for all actions, see Errors.

See alsoSee also

  • Yandex Cloud Notification Service HTTP API overview
  • Sending an HTTP API request to Yandex Cloud Notification Service
  • ListEndpointsByPlatformApplication API action in the AWS documentation.

Was the article helpful?

Previous
SetAttributes
Next
Delete
© 2025 Direct Cursus Technology L.L.C.