Authenticate as an API user

Obtain Authentication Token

To access Ledger Enterprise Apis as an API user, you need to obtain an authentication token by making a POST request to the authentication endpoint. Use the following example:

Bash

curl --request POST \
  --url https://api.vault.ledger.com/auth/token \
  --header 'content-type: application/json' \
  --header 'x-ledger-workspace: minivault' \
  --data '{"api_key_id": "yqjrwdngm15ml12u4opscq","api_key_secret": "Hc5mFFhnpeMoj6kZsCQXOphPMawIWAGnUxE8bvw5Kv0"}'

JSON

{
    "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJ4ek5yelNjeVNjM0J4RlhjaklaNWNtV0paSG1jRUhVU2VGVExKTXVwbl9jIn0.eyJleHAiOjE3MDU1MDQ1NzksImlhdCI6MTcwNTUwNDI3OSwianRpIjoiZDQwY2E2MzUtN2VjYS00ZmRkLTgwMWItNDY0YmZmMzBkZjI4IiwiaXNzIjoiaHR0cHM6Ly9ibHVlLWJhZGdlci00MzMubWluaXZhdWx0LmxlZGdlci1zYnguY29tL2tleWNsb2FrL3JlYWxtcy9taW5pdmF1bHQiLCJzdWIiOiJmOTczOTJlZC1hNjVmLTQ4ZGQtYjkwZi03NTk2NGFiN2ZjNmYiLCJ0eXAiOiJCZWFyZXIiLCJhenAiOiJyZXZhdWx0Iiwic2Vzc2lvbl9zdGF0ZSI6ImY5Yjk1Nzk5LTM1NTMtNDQ5ZC1hNGZkLTIxNDYzNzY1Mjc5YiIsInNjb3BlIjoiIiwic2lkIjoiZjliOTU3OTktMzU1My00NDlkLWE0ZmQtMjE0NjM3NjUyNzliIiwid29ya3NwYWNlIjoibWluaXZhdWx0IiwicHViX2tleSI6IjA0NzAwZTUwOGM4NTdhYTg5ZDlmZmZjNmViNzJiZjZmMjVkYzdiMGM1NGIxMzc4OTIxYmJiYjY3MWUzY2U3Y2M0YmU3ZWRkOGExOTgyYmM5MjkyMGY0NjY5MzFmOWYzN2Y2NTBjMDcwZDc5ZGVlMWI4OTZmZjQwODdmNzg5MDk4MDAifQ.MxTA8JkgJbNyHevZTihdUSthCZlezu7lUAsa09invGy5tWXO56lTXAiNRXc2rQB4AwljzrT1RUrCTIkT1ZGe36GUt3ganJOAiQzFUPdjm-lJC0GC14dHI0CLcP6tJMKR6ISBUkermdwPXmuWRrb8wAlH3b7kXVE-2nsEl5G5oPSqcwIPgie0tSwecg_pP0HNGtX0aoRS7dfEj6dreRC21Gxt5Sy2BtF3u1LltfgiOmoHvTGZkpz3xNektUdyDNIPke0flcOS12t1OakuoxA6Vgh7UyRamwU30-WjoYEZT_073b0Y6mKlzBYZ6i61vnMaS_1KNjPlovqeraIlTDs4Pw",
    "expires_in": 300,
    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI1MjA3Y2IwZC1mZmMwLTRiY2MtYjg1Mi1mYjIyNTFkODA2NDUifQ.eyJleHAiOjE3MDU1MDYwNzksImlhdCI6MTcwNTUwNDI3OSwianRpIjoiZDVmZGE0YWQtZmU5MC00NDA4LWFhMTAtODgwNzhkYzg2YzdiIiwiaXNzIjoiaHR0cHM6Ly9ibHVlLWJhZGdlci00MzMubWluaXZhdWx0LmxlZGdlci1zYnguY29tL2tleWNsb2FrL3JlYWxtcy9taW5pdmF1bHQiLCJhdWQiOiJodHRwczovL2JsdWUtYmFkZ2VyLTQzMy5taW5pdmF1bHQubGVkZ2VyLXNieC5jb20va2V5Y2xvYWsvcmVhbG1zL21pbml2YXVsdCIsInN1YiI6ImY5NzM5MmVkLWE2NWYtNDhkZC1iOTBmLTc1OTY0YWI3ZmM2ZiIsInR5cCI6IlJlZnJlc2giLCJhenAiOiJyZXZhdWx0Iiwic2Vzc2lvbl9zdGF0ZSI6ImY5Yjk1Nzk5LTM1NTMtNDQ5ZC1hNGZkLTIxNDYzNzY1Mjc5YiIsInNjb3BlIjoiIiwic2lkIjoiZjliOTU3OTktMzU1My00NDlkLWE0ZmQtMjE0NjM3NjUyNzliIn0.jzPFvjntSSXCwAyGuADwDJLTgFcIlEwZoiCcN8TxEno",
    "session_state": "f9b95799-3553-449d-a4fd-21463765279b",
    "token_type": "Bearer"
}

This request returns an access_token, which you will use in subsequent authenticated requests.