Getting Started
What you will need
The service is oriented to our partners. No special requirements, apart from requesting credentials.
Two options are supported to access this API.
• OAuth2 access, where you submit your credentials to retrieve a short-lived token, you then provide the access token in the API call via the Authorization Bearer header.
• Apikey access, where you provide the long-lived apikey as a query parameter
OAuth2 is supported by all the APIs in our catalog and is the prefered solution. Please use the “Contact Us” link on https://developer.se.com to request an new apikey or OAuth2 credentials. Your request will be referred to the API owner for validation.
How it works
API Endpoint (Base URL)
Token URL
| Environment | Token URL |
| Production | https://api.se.com/token |
| Environment | API URL |
| Production | https://api.se.com/v1/reference-data/product/digital-asset |
Apikey Access
Once you have an apikey, you can exercise both GET operations directly in a web browser.
Here are examples of both Get operations. Replace “your-apikey” with the actual value of your apikey.
https://api.se.com/v1/reference-data/product/digital-asset/360/view?cr=BMXP342020&apikey=your-apikey
https://api.se.com/v1/reference-data/product/digital-asset/360/viewer-url?cr=BMXP342020&apikey=your-apikey
OAuth2 Access
Once you have a Client ID and Client Secret, follow these steps to retrieve an access token. The sequence needs to be repeated before the token expires in 1 hour.
Token Generation Sample using Postman:
1. Select POST and enter the Token URL.
2. From the Body tab, click on radio button x-www-form-urlencoded.
3. Manually enter Key and Value, “grant_type” and “client_credentials”.
4. From the Authorization tab, select Type “Basic Auth”.
5. Set Username to the client key (provided to you by the APIFIRST team offline).
6. Set Password to the client secret (provided to you by the APIFIRST team offline).
7. Send request and retrieve value of access_token from the response message.
Sample curl for Token
curl -X POST \
https://api.se.com/token \
-H 'Accept: */*' \ -H 'Content-Type: application/x-www-form-urlencoded' \ -H 'Authorization: Basic OFNkWlFqTVVGbWthNG1tVVhvTGUxajcxY2VHQUxBczY6YzQ0MjlOa1VMS3FRQkJDMA==' \ -d grant_type=client_credentials