Auth API (1.0)

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

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
application/x-www-form-urlencoded
username=foo%40bar.com&password=gI7XPWVM2LhFX6u9akz0cGTDoRJNXUov
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"
}