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     /customers/register (POST)

Create a new customer record via registration.


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 -X POST 'https://marketplace-api.curios.com/customers/register' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'

-d '{
  "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}"
}'

Register Verify     /customers/registerVerify (POST)

Completes 2FA verification of email address for registration, and logs the user in.


Body
Argument Value Required Description
email {emai} Yes The email address of the customer who just registered.
email_token {email_token} Yes The token that was emailed to the customer upon registration. 
curl -X POST 'https://marketplace-api.curios.com/customers/registerVerify' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'

-d '{
  "email": "{emai}", 
  "email_token": "{email_token}"
}'

Login     /customers/login (POST)

Login an existing customer.


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

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'

-d '{
  "email": "{email}", 
  "password": "{password}"
}'

Login Verify     /customers/verify (POST)

Verify two-factor code for a customer login.


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 -X POST 'https://marketplace-api.curios.com/customers/verify' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'

-d '{
  "email": "{email}", 
  "verificationToken": "{verificationToken}", 
  "verificationCode": "{verificationCode}"
}'

Reset Password     /customers/resetPassword (POST)

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


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

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'

-d '{
  "email": "{email}"
}'

Reset Password Step 2     /customers/resetPasswordComplete (POST)

The second and final step in changing a customers password.


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 -X POST 'https://marketplace-api.curios.com/customers/resetPasswordComplete' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'

-d '{
  "email": "{email}", 
  "new_password": "{new password}", 
  "reset_code": "{password reset code}"
}'

Profile     /customers/profile (GET)

Customer profile details.


Authorization
Header Value Description
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification. 

curl -X GET 'https://marketplace-api.curios.com/customers/profile' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'
-H 'Authorization: Bearer {JWT}' \

Update     /customers/ (POST)

Update the customer profile details.


Authorization
Header Value Description
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification.

Body
Argument Value Required Description
first_name {first_name} No First name of the customer/user.
last_name {last_name} No
display_name {display_name} No
email {email} No
phone {phone} No
is_subscribed {is_subscribed} No
is_whitelisted {is_whitelisted} No
avatar {avatar} No 
curl -X POST 'https://marketplace-api.curios.com/customers/' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'
-H 'Authorization: Bearer {JWT}' \ 
-d '{
  "first_name": "{first_name}", 
  "last_name": "{last_name}", 
  "display_name": "{display_name}", 
  "email": "{email}", 
  "phone": "{phone}", 
  "is_subscribed": {is_subscribed}, 
  "is_whitelisted": {is_whitelisted}, 
  "avatar": "{avatar}"
}'

Collections     /customers/collections (GET)

Groups of tokens owned by a customer.


Authorization
Header Value Description
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification. 

curl -X GET 'https://marketplace-api.curios.com/customers/collections' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'
-H 'Authorization: Bearer {JWT}' \

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

Collection-specific tokens owned by a customer.


Authorization
Header Value Description
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification. 

curl -X GET 'https://marketplace-api.curios.com/customers/collections/:id/tokens' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'
-H 'Authorization: Bearer {JWT}' \

Redeem     /customers/redeem (POST)

Saves referral data to redeem free airdrops and other things.


Authorization
Header Value Description
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification.

Body
Argument Value Required Description
ref_source {ref_source} No A free-form string to store a description of the source where this redemption came from.
ref_campaign {ref_campaign} No Identifier for the campaign that the redemption is for.
ref_id {ref_id} No Unique identifier tied to the individual redemption. 
curl -X POST 'https://marketplace-api.curios.com/customers/redeem' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'
-H 'Authorization: Bearer {JWT}' \ 
-d '{
  "ref_source": "{ref_source}", 
  "ref_campaign": {ref_campaign}, 
  "ref_id": "{ref_id}"
}'

Tokens     /customers/tokens (GET)

All tokens owned by a customer.


Authorization
Header Value Description
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification. 

curl -X GET 'https://marketplace-api.curios.com/customers/tokens' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'
-H 'Authorization: Bearer {JWT}' \

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

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


Authorization
Header Value Description
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification. 

curl -X GET 'https://marketplace-api.curios.com/customers/tokens/:id' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'
-H 'Authorization: Bearer {JWT}' \

Sales     /customers/sales (GET)


Authorization
Header Value Description
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification. 

curl -X GET 'https://marketplace-api.curios.com/customers/sales' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'
-H 'Authorization: Bearer {JWT}' \

Payouts     /customers/payouts (GET)


Authorization
Header Value Description
Authorization Bearer {JWT} The JWT session token issued upon succesful customer login and verification. 

curl -X GET 'https://marketplace-api.curios.com/customers/payouts' \

-H 'Content-type: application/json'
-H 'curios-api-key: {API Key}'
-H 'curios-date: {UTC Date/Time Stamp}'
-H 'Authorization: Bearer {JWT}' \