API / Customers

Register and authenticate customers to create a session token for access to customer endpoints. Using authentication token (JWT), access all customer information, profile, wallets transactions and more.

Register   /v2/api/customers/register (POST)

Create a new customer record via registration.


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.

Body
Argument Value Required Description
email {email} Yes The email address of the customer.
password {password} Yes The password entered by the customer, must follow minimum password security requirements.
first_name {first name} No The first name of the customer
last_name {last name} No The last name of the customer
terms_agree {true/false} No Confirm whether or not this customer has checked a box to agree to the Terms in the license account.
privacy_agree {true/false} No Confirm whether or not this customer has checked a box to agree to the Privacy in the license account.
is_subscribed {true/false} No Confirm whether or not this customer has checked a box to agree to be marketed to from this license account.
phone {mobile phone} No Mobile phone number tied to customer.
display_name {username or display name} No A display name that will be their public facing alias. 
curl --location --request POST 'https://api.curios.com/v2/api/customers/register' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \ 
--data-raw '{
  "email": "{email}", 
  "password": "{password}", 
  "first_name": "{first name}", 
  "last_name": "{last name}", 
  "terms_agree": {true/false}, 
  "privacy_agree": {true/false}, 
  "is_subscribed": {true/false}, 
  "phone": "{mobile phone}", 
  "display_name": "{username or display name}"
}'

Login   /v2/api/customers/login (POST)

Login an existing customer.


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.

Body
Argument Value Required Description
email {email} Yes The email address of the customer.
password {password} Yes The password entered by the customer. 
curl --location --request POST 'https://api.curios.com/v2/api/customers/login' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \ 
--data-raw '{
  "email": "{email}", 
  "password": "{password}"
}'

Verify   /v2/api/customers/verify (POST)

Verify two-factor code for a customer login.


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.

Body
Argument Value Required Description
email {email} Yes The email address of the customer.
verificationToken {verificationToken} Yes The verification token that was returned by the /login resource.
verificationCode {verificationCode} Yes The verification code that was emailed to the customer. 
curl --location --request POST 'https://api.curios.com/v2/api/customers/verify' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \ 
--data-raw '{
  "email": "{email}", 
  "verificationToken": "{verificationToken}", 
  "verificationCode": "{verificationCode}"
}'

Reset Password   /v2/api/customers/resetPassword (POST)

Set a new password for a customer if they are having trouble logging in.


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.

Body
Argument Value Required Description
email {email} Yes Email address of the customer. 
curl --location --request POST 'https://api.curios.com/v2/api/customers/resetPassword' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \ 
--data-raw '{
  "email": "{email}"
}'

Reset Password Step 2   /v2/api/customers/resetPasswordComplete (POST)

The second and final step in changing a customers password.


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.

Body
Argument Value Required Description
email {email} Yes Email address of the customer.
new_password {new password} Yes The new password to save.
reset_code {password reset code} Yes Code sent by email to customer. 
curl --location --request POST 'https://api.curios.com/v2/api/customers/resetPasswordComplete' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \ 
--data-raw '{
  "email": "{email}", 
  "new_password": "{new password}", 
  "reset_code": "{password reset code}"
}'

Profile   /v2/api/customers/profile (GET)

Customer profile details.


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification.

Body
Argument Value Required Description 
curl --location --request GET 'https://api.curios.com/v2/api/customers/profile' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
--header 'Authorization: Bearer {JWT}' \

Update   /v2/api/customers/update (POST)

Update the customer profile details.


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification.

Body
Argument Value Required Description 
curl --location --request POST 'https://api.curios.com/v2/api/customers/update' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
--header 'Authorization: Bearer {JWT}' \

Collections   /v2/api/customers/collections (GET)

Groups of tokens owned by a customer.


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification.

Body
Argument Value Required Description 
curl --location --request GET 'https://api.curios.com/v2/api/customers/collections' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
--header 'Authorization: Bearer {JWT}' \

Collection Tokens   /v2/api/customers/collections/:id/tokens (GET)

Collection-specific tokens owned by a customer.


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification.

Body
Argument Value Required Description 
curl --location --request GET 'https://api.curios.com/v2/api/customers/collections/:id/tokens' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
--header 'Authorization: Bearer {JWT}' \

Tokens   /v2/api/customers/tokens (GET)

All tokens owned by a customer.


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification.

Body
Argument Value Required Description 
curl --location --request GET 'https://api.curios.com/v2/api/customers/tokens' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
--header 'Authorization: Bearer {JWT}' \

Token Details   /v2/api/customers/tokens/:id (GET)

Details and secure assets for a token owned by a customer.


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification.

Body
Argument Value Required Description 
curl --location --request GET 'https://api.curios.com/v2/api/customers/tokens/:id' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
--header 'Authorization: Bearer {JWT}' \

Sales   /v2/api/customers/sales (GET)


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification.

Body
Argument Value Required Description 
curl --location --request GET 'https://api.curios.com/v2/api/customers/sales' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
--header 'Authorization: Bearer {JWT}' \

Payouts   /v2/api/customers/payouts (GET)


Headers
Header Value Description
curios-api-key {API Key} API Key for your licence account, retrieve from your admin dashboard.
curios-date {UTC Date/Time Stamp} API Key for your licence account, retrieve from your admin dashboard.
curios-signature {Signature} A calculated signature, see instructions here.
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification.

Body
Argument Value Required Description 
curl --location --request GET 'https://api.curios.com/v2/api/customers/payouts' \

--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
--header 'Authorization: Bearer {JWT}' \