Auth API (1.0)

All Simacan APIs require Bearer authentication (also called token authentication). The Auth API provides you with the tokens needed.

API Documentation

Request access token

Authenticate with username and password credentials for an access and refresh token pair.

Request
Request Body schema: application/x-www-form-urlencoded

Request access token

username
string

Your personal username, provided by Simacan

password
string

Your personal password, provided by Simacan

Responses
200

Indicates that your request was successful.

401

Unauthorized

post/auth/password
Request samples
import requests

url = "https://auth-service.services.simacan.com/api/v1/auth/password"

payload = {
  "username": "foo@bar.com",
  "password": "gI7XPWVM2LhFX6u9akz0cGTDoRJNXUov"
}

headers = {"Content-Type": "application/x-www-form-urlencoded"}

response = requests.post(url, data=payload, headers=headers)

data = response.json()
print(data)
Response samples
application/json
{
  • "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJDYjZZbGdHeWNrR3JjWWRxcmNFcUphdW5IRTVfdk5ZMTFjUVIwdHlmX3RvIn0.eyJqdGkiOiI1MzIyMWJmZC1lN2JkLTQzMTgtODhhMS1hZWNhNDgwOGQ1ODgiLCJleHAiOjE2MDY3MzQwMTEsIm5iZiI6MCwiaWF0IjoxNjA2NzMwNDExLCJpc3MiOiJodHRwczovL3Nzby1zdGcuc2ltYWNhbi5jb20vYXV0aC9yZWFsbXMvc2ltYWNhbl90cmFuc3BvcnRfY2xvdWQiLCJhdWQiOiJhdXRoLWFwaSIsInN1YiI6IjRlNTBjOWNkLTQ4OGEtNDdiOS05MDU4LWNlYTIzMGRiZTNiYSIsInR5cCI6IkJlYXJlciIsImF6cCI6ImF1dGgtYXBpIiwiYXV0aF90aW1lIjowLCJzZXNzaW9uX3N0YXRlIjoiOWMyOTMxY2QtZTU2My00OGM1LTlhNTEtYWIwYTg4M2VhYjljIiwiYWNyIjoiMSIsImFsbG93ZWQtb3JpZ2lucyI6W10sInJlc291cmNlX2FjY2VzcyI6e30sInNjb3BlIjoiIiwibmFtZSI6ImFwaS1kZW1vLWFjY291bnRAc2ltYWNhbi5jb20gYXBpLWRlbW8tYWNjb3VudEBzaW1hY2FuLmNvbSIsInByZWZlcnJlZF91c2VybmFtZSI6ImFwaS1kZW1vLWFjY291bnRAc2ltYWNhbi5jb20iLCJnaXZlbl9uYW1lIjoiYXBpLWRlbW8tYWNjb3VudEBzaW1hY2FuLmNvbSIsImZhbWlseV9uYW1lIjoiYXBpLWRlbW8tYWNjb3VudEBzaW1hY2FuLmNvbSIsImVtYWlsIjoiYXBpLWRlbW8tYWNjb3VudEBzaW1hY2FuLmNvbSJ9.UhZo-Duy7EeeIZqdjgBJki3qr8bOJSqS-MBv8WEN3-GuZP2NiBTnK4MsmA8r9KxcijMXPTwJUHYoKi4h0elsiuRWythP3BwZfC_PzSDMNEAxNL4dTh6H671f3GlJfGVk74xJvaq1gDlaHIJ-2Z-HK_7zSqNv9lOUF8puyZ5esu_XIyxRPKbXkIuwbqSh_8eIt9tyP8og33JZ22srnT41f30k2bOuZWrAuZ-jw1Fx47aB7AMQRvFNjVidUI8L_TQXjA0oAeBsawC7PkYaBqsTl_xEihj4qbHlVTmYoSLZa19OLRSQsd6bLLK768Oatw-wLSeINcnkbP41OnMowBTSUQ",
  • "refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJDYjZZbGdHeWNrR3JjWWRxcmNFcUphdW5IRTVfdk5ZMTFjUVIwdHlmX3RvIn0.eyJqdGkiOiI2OTNiYjhiMS0yZjhjLTQzOGYtYjViNy1jY2RlNDRkYmZhNWMiLCJleHAiOjE2MDY4MTY4MTEsIm5iZiI6MCwiaWF0IjoxNjA2NzMwNDExLCJpc3MiOiJodHRwczovL3Nzby1zdGcuc2ltYWNhbi5jb20vYXV0aC9yZWFsbXMvc2ltYWNhbl90cmFuc3BvcnRfY2xvdWQiLCJhdWQiOiJhdXRoLWFwaSIsInN1YiI6IjRlNTBjOWNkLTQ4OGEtNDdiOS05MDU4LWNlYTIzMGRiZTNiYSIsInR5cCI6IlJlZnJlc2giLCJhenAiOiJhdXRoLWFwaSIsImF1dGhfdGltZSI6MCwic2Vzc2lvbl9zdGF0ZSI6IjljMjkzMWNkLWU1NjMtNDhjNS05YTUxLWFiMGE4ODNlYWI5YyIsInJlc291cmNlX2FjY2VzcyI6e30sInNjb3BlIjoiIn0.j1XcwIZhfcMj8nCvCOyEXEPiVMvnarpvayEDsCNfZhTWQviH6aTT69BLjM_D-hRipfiQPjiSFjujVwYCT5iFAXnQgV0CjBvb8CO1acxU5lY283ckhHF9cmKm5BxwtBCgj30ELDRSDUvYT_J4fAZU05GXkZQtCGSkZS-Ab8J45it4_EFv_k-mi7fpzrQkLM8LhqUJL90DmQRbbheaEdaZ4CUVwhQRIiX0NKJLvpOB2Ne8CS2eZc2g4TwJknqdg_1UUjkgvUPA-Z1qVYAel9ASygNDn4LYrnrlxZ3bvXw1vXk71l06KGi3vZMt33ipzrucAJuP8_I2lMrERnT57nZCqg",
  • "token_type": "bearer",
  • "expires_in": "3600"
}