Synerise API Reference (4.4)

Download OpenAPI specification:Download

Welcome to Synerise API Reference! We hope that you'll enjoy your stay here.

If you need help with our services, feel free to contact us at support@synerise.com.

To open Synerise's collection in Postman, click here: Run in Postman

Remember that every API call must have these headers:

Header Name Header Value
Accept application/json
Content-Type application/json
Api-Version: 4.4
Authorization (does not apply to Logs in endpoints) Bearer {JWT token}

Authentication

JWT

Synerise uses JSON Web Token (JWT) as the authorization method. The token is generated by the auth/login endpoint. You need to include it in the Authorization header of your requests, with a Bearer prefix. See this simplified example of a call:

curl -X GET https://api.synerise.com/v4/clients \
-H 'Accept: application/json' \
-H 'Api-Version: 4.4' \
-H 'Authorization: Bearer eyJhbGciOiJSzZXIiLCJjdGQiOjE1NTI0NjMzMjg4NjIsImF1dGgiOiJINHNJQUFBQUFBQUFBSXVPQlFBcHUwd05BZ0FBQUE9PSIsIm5tZSI' \
-H 'Content-Type: application/json'

Remember to include a space between Bearer and the token.

The token is valid for one hour (unless configured differently). You can request a refreshed key for the session by using the auth/refresh endpoint before the current token expires.

You can verify your JWT signature by using the public key.

Security scheme type: HTTP
HTTP Authorization Scheme bearer

Authorization

Synerise API Consumer Types

Synerise defines two different types of API consumers:

Client

This is the end user of your website or application - the one who browses pages, purchases items, and so on. The client can register and maintain their own account. They can also perform other customer actions, such as redeeming vouchers. The Client can access and modify only their own data.

Business Profile

The Business Profile is assigned to a particular company. This consumer can use methods that, for example, create client accounts, record client actions, or manage promotions.

Synerise API Consumer Types

Synerise defines two different types of API consumers:

Client

This is the end user of your website or application - the one who browses pages, purchases items, and so on. The client can register and maintain their own account. They can also perform other customer actions, such as redeeming vouchers. The Client can access and modify only their own data.

Business Profile

The Business Profile is assigned to a particular company. This consumer can use methods that, for example, create client accounts, record client actions, or manage promotions.

Refresh a Business Profile token

Retrieve a refreshed JWT Token to prolong the Business Profile session.

You must be logged in as Business Profile and have an active token.

Authorizations:
header Parameters
Accept
required
string
Value: "application/json"
Content-Type
required
string
Value: "application/json"
Api-Version
required
string
Value: "4.4"

Responses

200

New authorization token

401

Unauthorized

get /v4/auth/refresh/profile
https://api.synerise.com/v4/auth/refresh/profile

Request samples

Copy
curl --request GET 
  --url https://api.synerise.com/auth/refresh/profile 
  --header 'accept: application/json' 
  --header 'api-version: 4.4' 
  --header 'content-type: application/json'

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "token": "eyJhbGciOiJSUzUxMiJ9.eyJzdWIiOiI2NDJlOTJlZmI3OTQyMTczNDg4MWI1M2UxZTFiMThiNiIsImF1ZCI6IkFQSSIsInJsbSI6ImJ1c2luZXNzX3Byb2ZpbGUiLCJjdGQiOjE1NTMwMDM5OTA0MTUsImF1dGgiOiJINHNJQUFBQUFBQUFBSXNPY25YMDhZMTM5dkYwOVF1SmQzUjI5Zy8xQzlGUlFCYUY4VnpEa0RnaFFZNSt3WTdPSVo3K2ZyRUFHdGRoUWtRQUFBQT0iLCJpc3MiOiJTeW5lcmlzZSIsImJwaSI6NDgsImV4cCI6MTU1MzAwNzU5MCwiYXBrIjoiOTEzODE5OTMtRDlFQy04MEIxLUIwMzMtOTExMjNDRENFRjFDIn0.Y1u4RgHitcgBhfejqaAEHt9WV8eSm7csO8A2RFGa_iXaLsPh4k72-f4TLMxANculh8tAbnM531k-cMPXbqMulATeL5X-c8Ko-Et_Kl2JF0bIRJY4PnGqQthQYw9OiQGvay6tWKwIVm6aZacaLefYw7MvnlMKW2LI2-gZAHnkzAQntR-EXLXMFn-Zv_KxHF_kzKPQY2IgT_7Whyc4tBFFi2u5wq2fiRwd3qr2WshZ2b5Um7Z7Sz6L-j4XYDOgu0QHbDdu6DYQSt7GQaGlXSvL3eJ0ZXwk7jp9Gqzx8CgYER2WH80w84RSVLLJQISEJuHTe_cZvcpdPp0F7v_P18S4-gjJeHWN8G8Mez0kkhswBC8vYQELeU7pvEe5cHLufyrtBJCCo_GKXPssQ9kPOKhsC3afOaz5EqD8XolpZY_FD4vil5sNHnfolkzBQrS26mZInbKLjbddFYw7OXmILPAkV5XzujUPgZbQ1InkIVOxTXPWlkaFW_ZyoFrdEo1WeFs1FGpmGs6FW3fQbulBZC0R5kr_U3-1K7i1Ts9vTbMdmesyfI_wGMwIrxK2wd7_LU5wMR6W8ppoZJ8a8CzNiWJQAn7yB0Zis2rsnvvM-YLBAILt6xKkfPcUMkbLqP_Iz8VwGDmMwSN6zBYqzu_m0CpJ15YWiOpYkWcoDPYkGSsWBPM"
}

Log in as Business Profile

Obtain a new Business Profile JWT Token.

Authorizations:
header Parameters
Accept
required
string
Value: "application/json"
Content-Type
required
string
Value: "application/json"
Api-Version
required
string
Value: "4.4"
Request Body schema: application/json
apiKey
required
string

Responses

200

Business Profile authorization token

401

Unauthorized

post /v4/auth/login/profile
https://api.synerise.com/v4/auth/login/profile

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apiKey": "91381993-D9Einvalid91123CDCEF1C"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "token": "eyJhbGciOiJSUzUxMiJ9.eyJzdWIiOiI2NDJlOTJlZmI3OTQyMTczNDg4MWI1M2UxZTFiMThiNiIsImF1ZCI6IkFQSSIsInJsbSI6ImJ1c2luZXNzX3Byb2ZpbGUiLCJjdGQiOjE1NTMwMDQ3Mzk2NTUsImF1dGgiOiJINHNJQUFBQUFBQUFBSXNPY25YMDhZMTM5dkYwOVF1SmQzUjI5Zy8xQzlGUlFCYUY4VnpEa0RnaFFZNSt3WTdPSVo3K2ZyRUFHdGRoUWtRQUFBQT0iLCJpc3MiOiJTeW5lcmlzZSIsImJwaSI6NDgsImV4cCI6MTU1MzAwODMzOSwiYXBrIjoiOTEzODE5OTMtRDlFQy04MEIxLUIwMzMtOTExMjNDRENFRjFDIn0.dllaEzYPDXqWPLLUOAUwHOpYLc4-Aj_vkBZb3e7kPo6FZYw5fEAqaoFG1sUoz0HYETJqZ_30UnYBwhbM6qhXGiuoNDiO3f5V0NVSP9DObq_rAtx4FdPtvfjaMXdFkzlTVK8GZSCRJU9Jtvm5_G-KR5hmCOOnJFeU68LJuVtnK2TikRg2v1rhyKODjpcCY9mvPoVrDheOKRE-XGAONSnz2lHMrFpDffhrR-Ten5hu0Z10oUUO5cr0CMBPEqLESZEadwzzxhcum7MLyiejsbYaoQx-XdI8Gys2SpmCtcOnTySs1M3tX6Gdv5QjASYIm32fTPEm82X9dPWYGQO4UG79vwr9kaXzIBVB_iJs9TazTnIrIkbWgqUNQ17bSe6MVBqwmlzv_NxCaSvKAbYqe9FLxcuSGXXUamNdMkwB3Kf1BLs1JTWhBZJXPUSS2eJBcPCxoiTMKu2jNR7cnlRf4iBdzOE60j5aynn1D68HZ1BnZcq_mGYtEJLK3mShtypcFy3kGaWN76uedPwVNH-OFYZeNacb1qxCkNmaJPE71hiP5nUiXmB_AlgkHZA5C7F3iB4i_SruqECEBTMnLjj0TRih7BUdadjI16We-5AKWYlk1YTN3jSKXdnHc0Ht7Ok6xLPr7Zk5v8xEiWY0dDE31CJCtzME7nGnn8KGRIZFkwT1bm4"
}

Refresh a Client token

Retrieve a refreshed JWT Token to prolong the Client session.

You must be logged in as Client and have an active token.

Authorizations:
header Parameters
Accept
required
string
Value: "application/json"
Content-Type
required
string
Value: "application/json"
Api-Version
required
string
Value: "4.4"

Responses

200

New authorization token

401

Unauthorized

get /v4/auth/refresh/client
https://api.synerise.com/v4/auth/refresh/client

Request samples

Copy
curl --request GET 
  --url https://api.synerise.com/auth/refresh/client 
  --header 'accept: application/json' 
  --header 'api-version: 4.4' 
  --header 'content-type: application/json'

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "token": "eyJhbGciOiJSUzUxMiJ9.eyJzdWIiOiI3ZTZjYmMwMTBlZmJhMTliOTkwMTFhNWU1ZGQ4MDViMiIsImF1ZCI6IkFQSSIsInJsbSI6ImNsaWVudCIsImN0ZCI6MTUyODM1NTgzMjEzOCwiZW1sIjoia3J6eXN6dG9mLmN6ZXJlcGFrQGdtYWlsLmNvbSIsImlzcyI6IlN5bmVyaXNlIiwiYnBpIjo1OTQsImNsSWQiOjUyNTQ0NjU3NCwinvalidx2XwJp-QBZ94d_EEKf41KtDCE33KhP_vTAYrs-JzbnIHgKRvG6ZRwsNOL8OTnbfbUZH4XYaqBB_tZTPPKfzHutP6GEGp7PLtu2E92JbChkVyrn8VCQ5v4z2e1-zsdgbmWcQk2g9RydaydO6NYO55suT3Hz2ZRv0AYLsG8rM1biZGdREWx9OaknVVuIo2ivehBiukL7VQ6Bu8ugjep3mn-z666a-nCMh6ZuASiQ6Geq0NSWmdDQIoCa5Hg44KzMfGRlCR2uKBXeHTD0SkwJ1VJM0sHNKwSfMXKpaX8OJ5wUJpgCzDzQwKVgxgWFp4eO_sbcvxWrpI7W0lfdCy1WKirnZ6Uh3uJ06v97GQDAQqVgBZFEpS47MrGZhTNuAG4ZbfYO7yyxVO8AHQbEC-UvZ-8DC1XZjvQ6S1uNqQIlVGcthnrxg8K6vKVhNzu6ifQI0bbsCl8bGsKkXOEK1pKR3ekckcSjNeeY2LrcdXs8F2gtkm0TjXU"
}

Log in as Client

Obtain a new Client JWT Token.

header Parameters
Accept
required
string
Value: "application/json"
Content-Type
required
string
Value: "application/json"
Api-Version
required
string
Value: "4.4"
Request Body schema: application/json
apiKey
required
string

Client API key

email
required
string

Client e-mail

password
required
string

Client password

uuid
required
string

Client UUID

Responses

200

Client authorization token

401

Unauthorized

post /v4/auth/login/client
https://api.synerise.com/v4/auth/login/client

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apiKey": "5AEAA3D5-E147-C7EB-invalid50109A3D1",
  • "email": "testDoc@example.com",
  • "password": "testPass1!",
  • "uuid": "b3f56868-9667-4843-a8e5-0509456baa9b"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "token": "eyJhbGciOiJSUzUxMiJ9.eyJzdWIiOiI3ZTZjYmMwMTBlZmJhMTliOTkwMTFhNWU1ZGQ4MDViMiIsImF1ZCI6IkFQSSIsInJsbSI6ImNsaWVudCIsImN0ZCI6MTUyODM1NTgzMjEzOCwiZW1sIjoia3J6eXN6dG9mLmN6ZXJlcGFrQGdtYWlsLmNvbSIsImlzcyI6IlN5bmVyaXNlIiwiYnBpIjo1OTQsImNsSWQiOjUyNTQ0NjU3NCwiZXhwIjoxNTI4MzU5NDMyLCJhcGsiOiI2MjIzNzZGOC00QThGLThCMjQtRDdGOS0wNzBGQTk1NkU5NjMifQ.LRGyk4jfdbnvQmXVOw_4YZBaTISjACLEqeieOiw3icjlfJEaDlB6HmrQ0apxNgwCKWruWRSUTzVaO7RB1_M45lLxda2AJ7dgegJu9kfa4hVxJSbGkVJEhtv1-C8x8OIOIyQ1Tj3ulSdq2AZbsjFtetUfiRqA-y8sg2OUiRm2OCahAbZL7otDi3VK8Jx2XwJp-QBZ94d_EEKf41KtDCE33KhP_vTAYrs-JzbnIHgKRvG6ZRwsNOL8OTnbfbUZH4XYaqBB_tZTPPKfzHutP6GEGp7PLtu2E92JbChkVyrn8VCQ5v4z2e1-zsdgbmWcQk2g9RydaydO6NYO55suT3Hz2ZRv0AYLsG8rM1biZGdREWx9OaknVVuIo2ivehBiukL7VQ6Bu8ugjep3mn-z666a-nCMh6ZuASiQ6Geq0NSWmdDQIoCa5Hg44KzMfGRlCR2uKBXeHTD0SkwJ1VJM0sHNKwSfMXKpaX8OJ5wUJpgCzDzQwKVgxgWFp4eO_sbcvxWrpI7W0lfdCy1WKirnZ6Uh3uJ06v97GQDAQqVgBZFEpS47MrGZhTNuAG4ZbfYO7yyxVO8AHQbEC-UvZ-8DC1XZjvQ6S1uNqQIlVGcthnrxg8K6vKVhNzu6ifQI0bbsCl8bGsKkXOEK1pKR3ekckcSjNeeY2LrcdXs8F2gtkm0TjXU"
}

Log in anonymously

Obtain a new JWT for an anonymous Client (without an existing Client profile). The token can be used and refreshed in the same way as tokens of registered Clients.

header Parameters
Accept
required
string
Value: "application/json"
Content-Type
required
string
Value: "application/json"
Api-Version
required
string
Value: "4.4"
Request Body schema: application/json
apiKey
required
string

Client API key (same as for Client login)

deviceId
string

Unique Android or iOS device ID

uuid
required
string

Client UUID

Responses

200

Anonymous authorization token

401

Unauthorized

post /v4/auth/login/client/anonymous
https://api.synerise.com/v4/auth/login/client/anonymous

Request samples

Content type
application/json
Copy
Expand all Collapse all
"{\"apiKey\":\"5AEAA3D5-E147-C7EB-invalid50109A3D1\",\"deviceId\":\"000000\",\"uuid\":\"622376F8-0000-2222-D7F9-070FA956E963\"}"

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "token": "eyJhbGciOiJSUzUxMiJ9.eyJzdWIiOiIzM2QwYjY5NWM4NjMwYmZkM2FkNDg2ZjQ3ZGRiMjE5MSIsImF1ZCI6IkFQSSIsInJsbSI6ImFub255bW91c19jbGllbnQiLCJjdGQiOjE1NTMwMDQxNTkxNTEsImVtbCI6IjYyMjM3NmY4LTAwMDAtMjIyMi1kN2Y5LTA3MGZhOTU2ZTk2M0Bhbm9ueW1vdXMuaW52YWxpZCIsImF1dGgiOiJINHNJQUFBQUFBQUFBSXVPQlFBcHUwd05BZ0FBQUE9PSIsImlzcyI6IlN5bmVyaXNlIiwiYnBpIjo0OCwiY2xJZCI6NDMzMjMwMjg4LCJleHAiOjE1NTMwMDcxNTksImFwayI6IjVBRUFBM0Q1LUUxNDctQzdFQi1ENTlFLUJDRjUwMTA5QTNEMSJ9.QOmSqrneR4mJFv4JdxTYsw_wGcDawDsVQuB-GVTcPPwijiP7lQ_Jzqq2Mypg1BS6WFlfGB8fzqCY9iMF_TdtjmoB4xBrY95ylU8L9qto-9Cw5x5TURkfxq31eryiHe2IteRAEtoVzYg2_s9QhlH6ANVcFOVp8dMno0V9bfMYfeSQa3FkjEbxFsseHkMOiADmp9-tOGtLXO942Ir-2W_Hz3Utlpt4erz0dVJBw8a-mFavPA8EEDWR7ACJNocrVHFkS3wFISh3LqLn6KkXiowaynKlJOEHGctuahzKmF3ZOJ1BvGgKohxF9OXvQs9IdmCfWhYsLr5Q2p04TJJ-MyvTipuggKVioh8mHmOFdfnN-Zused6tXzhZtKPUWTmM8cBKoAOBHExxcMQ8SVSjxnw_7_eLKm7S2wNpu0V-tiPZPCH4wYZXtWBYjmfy0V9ydjXnNunXfgxKixLeFNnONUXxEuqPLvM_xAuonQBXVN4nYrgJv8p8U6_ZlGMPjJq1szfcuBZnzI34LSEWx_nSof0XC5Czm8iG_ihG8naivNWS8h-Q-qKMP_3PPFsLSH4Egh03pH93EJUuNAeSO4RGfUX1wzMvrv1nBC1SM660uFMbq-wkplFBbKnHKMYe-qRs1-lZPG5PwPWJJdpGqOUzbnoMOJYmiq06OHHVQyJSkcEHLCk"
}

Authenticate with Facebook

Use a Facebook token to obtain a Client JWT Token. If a Facebook account is logging on for the first time, a Client account in Synerise is created.

Authorizations:
header Parameters
Accept
required
string
Value: "application/json"
Content-Type
required
string
Value: "application/json"
Api-Version
required
string
Value: "4.4"
Request Body schema: application/json
facebookToken
required
string

Facebook authentication token

apiKey
required
string

Client API key (same as for Client login)

uuid
required
string

Client UUID

deviceId
string

Unique Android or iOS device ID

agreements
object

Marketing agreements of the Client

You can also pass the values as strings ("true";"TRUE";"True"/"false";"FALSE";"False") or integers (1 for true and 0 for false).

attributes
object

Custom attributes

tags
Array of strings

Tags can be used to group Client accounts.

Responses

200

Client authorization token

post /v4/auth/login/client/facebook
https://api.synerise.com/v4/auth/login/client/facebook

Request samples

Content type
application/json
Copy
Expand all Collapse all
"{\"facebookToken\":\"EAAfsMmaWLW0BAOZAqSoh8ZB5y2ZAixtSrlvvq3fpWGlcrfcoWOiAwBCZBpBDlzwHFSZB58nUBjOz2UMuopO7p2Q65QU1ZAiB2XaxRzje0bBd7Tu87f6C2pcoZAP65agWAF0ElZCNyKn4iAtFd9RhppkwU9ll0AokBZBnDroZCIaxE3IHSWGtE567AUrXkZAsQEjYsZAZAcYx0ki1w7XUToy9Wps9NA0OuBdMhruB3htuiukwOFAZDZD\",\"apiKey\":\"5AEAA3D5-E147-C7EB-invalid50109A3D1\",\"uuid\":\"91b8e035-dca3-4805-8915-2cfb01d31fde\",\"deviceId\":\"deviceId\",\"agreements\":{\"email\":true,\"sms\":true,\"push\":true,\"bluetooth\":true,\"rfid\":true,\"wifi\":true},\"attributes\":{\"property1\":\"string\",\"property2\":\"string\"}}"

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "token": "eyJhbGciOiJSUzUxMiJ9.eyJzdWIiOiI3ZTZjYmMwMTBlZmJhMTliOTkwMTFhNWU1ZGQ4MDViMiIsImF1ZCI6IkFQSSIsInJsbSI6ImNsaWVudCIsImN0ZCI6MTUyODM1NTgzMjEzOCwiZW1sIjoia3J6eXN6dG9mLmN6ZXJlcGFrQGdtYWlsLmNvbSIsImlzcyI6IlN5bmVyaXNlIiwiYnBpIjo1OTQsImNsSWQiOjUyNTQ0NjU3NCwinvalidx2XwJp-QBZ94d_EEKf41KtDCE33KhP_vTAYrs-JzbnIHgKRvG6ZRwsNOL8OTnbfbUZH4XYaqBB_tZTPPKfzHutP6GEGp7PLtu2E92JbChkVyrn8VCQ5v4z2e1-zsdgbmWcQk2g9RydaydO6NYO55suT3Hz2ZRv0AYLsG8rM1biZGdREWx9OaknVVuIo2ivehBiukL7VQ6Bu8ugjep3mn-z666a-nCMh6ZuASiQ6Geq0NSWmdDQIoCa5Hg44KzMfGRlCR2uKBXeHTD0SkwJ1VJM0sHNKwSfMXKpaX8OJ5wUJpgCzDzQwKVgxgWFp4eO_sbcvxWrpI7W0lfdCy1WKirnZ6Uh3uJ06v97GQDAQqVgBZFEpS47MrGZhTNuAG4ZbfYO7yyxVO8AHQbEC-UvZ-8DC1XZjvQ6S1uNqQIlVGcthnrxg8K6vKVhNzu6ifQI0bbsCl8bGsKkXOEK1pKR3ekckcSjNeeY2LrcdXs8F2gtkm0TjXU"
}

Authenticate with Facebook without registration

Use a Facebook token to obtain a Client JWT Token for a Client that is not registered in Synerise.

Authorizations:
header Parameters
Accept
required
string
Value: "application/json"
Content-Type
required
string
Value: "application/json"
Api-Version
required
string
Value: "4.4"