How to Authenticate

Sesame uses Basic authentication for its APIs. Learn how to authenticate on this page.

After generating an API Token, the system displays the associated Username and password for authentication, which is based on the Basic authentication method.

If needed, a token can be retrieved after creation by navigating to Sesame Data > Destinations > API > Tokens > [Edit].

In your preferred tool, select the Authorisation type as Basic Auth. Your tool will prompt you to enter the Username and Password - input the credentials as provided by Sesame.

The simplest call that you can make is Entities, which returns all Legal Entities, Portfolios and Consolidations of your account. This endpoint does not require any additional request parameter, but if desired, providing an entity's ID in the url, the API will only return data for that single entity only.

The Authentication and requests to the Sesame Data APIs require:

1. Basic Authentication

• All API requests must include HTTP Basic Authentication credentials

• Include your credentials in the Authorisation header using the format: Basic {base64(username:password)}

2. Base URL https://data.api.landytech.net

3. Request Headers

• Content-Type: application/json (for POST requests)

• X-Result-Limit (optional): Maximum number of items to retrieve per request

• Type: Integer

• Example: 20

4. Standard Response Codes

• 200 - Successful request

• 401 - Unauthorised - missing or invalid authentication credentials

• 403 - Forbidden - authenticated user does not have permission to access the resource

Example Request (GET)

Use curl -u (recommended)

GET /api/v2/entities

curl -X GET "https://data.api.landytech.net/api/v2/entities" \
  -u "USERNAME:PASSWORD" \
  -H "X-Result-Limit: 20"

curl -u automatically sends the Authorization: Basic header.

Use Authorization header

Example Request (POST)

POST /api/v2/analytics

# Create the base64 value for "username:password"
ENCODED_CREDENTIALS="$(printf '%s' 'USERNAME:PASSWORD' | base64)"

curl 'https://data.api.landytech.net/api/v2/analytics' \
  -X POST \
  -H 'Content-Type: application/json' \
  -H "Authorization: Basic ${ENCODED_CREDENTIALS}" \
  -d '{
  "fields": [
    { "code": "ENTITY.ID" },
    { "code": "ENTITY.NAME" },
    { "code": "POSITION.DATE" },
    { "code": "ASSET.NAME" },
    { "code": "ASSET.TYPE" },
    { "code": "POSITION.CUSTODIAN_NAME" },
    { "code": "ENTITY.REPORTING_CURRENCY" },
    { "code": "POSITION.MARKET_VALUE_REPORTING" },
    {
      "name": "YTD Return",
      "code": "POSITION.RETURN",
      "parameters": { "period": "YTD" }
    },
    {
      "name": "1D VaR MC 95",
      "code": "POSITION.RISK",
      "parameters": { "risk_measure_id": 250 }
    },
    {
      "name": "Lehman Crisis (2008)",
      "code": "POSITION.RISK",
      "parameters": { "risk_measure_id": 522 }
    }
  ],
  "ids": [1, 2, 3],
  "consolidationType": "DIRECT",
  "since": "2025-09-30"
}'

You may also find it valuable to explore our tutorial on Using Sesame Data with Postman.

Users can troubleshoot the results by Viewing Logs.