EPC Directory Service (EDS) API is available over the Internet. This API uses Password grant type for issuing access tokens to client applications. Follow the information below to request an access token and use it to call the API endpoints defined in the EPC Directory Service (EDS) VOP API Reference or EPC Directory Service (EDS) SRTP API Reference.

Step 1: Request Access Token

Ensure you have completed these onboarding steps before you continue to the steps below.

Authorisation URL

Refer to the URLs under Authorisation API Base URLs to determine the URL you should use for accessing the API over the Internet in either the or environment.

Authorization Header

Refer to Authorization Header to learn how to use the consumer-key and consumer-secret from the app you created.

Request Body

Refer to Password grant type to learn the request parameters you should include in the API request.

Calling the authorisation API

Call the token API with the Authorisation URL, Authorization Header and Request Body explained above. An access token will be returned in the API response. The access_token is valid for 30 minutes. You can use the refresh_token for up to 24 hours.

Step 2: Use Access Token to call EPC Directory Service (EDS) API

When you have obtained an access token, you can use access token to call EPC Directory Service (EDS) API. You also have the option to refresh access token after it expires. We highly recommend that you dispose access token when it is no longer needed.