Accept terms and conditions for a user

curl --request POST \
  --url https://app.sandbox.rio.trade/api/users/{id}/terms/accept \
  --header 'x-api-key: <api-key>'

{
  "platformFeeRanges": {
    "MX": {
      "buy": [
        {}
      ],
      "sell": [
        {}
      ]
    },
    "US": {
      "buy": [
        {}
      ],
      "sell": [
        {}
      ]
    },
    "PE": {
      "buy": [
        {}
      ],
      "sell": [
        {}
      ]
    },
    "CO": {
      "buy": [
        {}
      ],
      "sell": [
        {}
      ]
    }
  },
  "createdAt": "2025-07-16T19:24:51.284Z",
  "type": "business",
  "phoneNumber": "+525561310992",
  "email": "[email protected]",
  "attributes": [
    "broker"
  ],
  "address": {
    "street1": "Amsterdam 76",
    "street2": null,
    "city": "Mexico City",
    "state": "CDMX",
    "country": "MX",
    "postalCode": "06100"
  },
  "brokerId": "6757546b4c5d19bf3cd7b09c",
  "onboarding": {
    "country": "MX",
    "status": "review",
    "hasAcceptedTerms": true,
    "aipriseUserVerificationSessionUrl": "https://verify-sandbox.aiprise.com/verification_session_id=bb321d1a-8037-44bf-a520-c9e2995fbb4d"
  },
  "businessData": {
    "businessName": "Company Name"
  },
  "individualData": {
    "firstName": "Name",
    "middleName": "Middle Name",
    "lastName": "Name",
    "secondLastName": "Last Name"
  },
  "id": "6877fc83509bb1423ee38202"
}

POST

api

users

{id}

terms

Accept terms and conditions for a user

curl --request POST \
  --url https://app.sandbox.rio.trade/api/users/{id}/terms/accept \
  --header 'x-api-key: <api-key>'

{
  "platformFeeRanges": {
    "MX": {
      "buy": [
        {}
      ],
      "sell": [
        {}
      ]
    },
    "US": {
      "buy": [
        {}
      ],
      "sell": [
        {}
      ]
    },
    "PE": {
      "buy": [
        {}
      ],
      "sell": [
        {}
      ]
    },
    "CO": {
      "buy": [
        {}
      ],
      "sell": [
        {}
      ]
    }
  },
  "createdAt": "2025-07-16T19:24:51.284Z",
  "type": "business",
  "phoneNumber": "+525561310992",
  "email": "[email protected]",
  "attributes": [
    "broker"
  ],
  "address": {
    "street1": "Amsterdam 76",
    "street2": null,
    "city": "Mexico City",
    "state": "CDMX",
    "country": "MX",
    "postalCode": "06100"
  },
  "brokerId": "6757546b4c5d19bf3cd7b09c",
  "onboarding": {
    "country": "MX",
    "status": "review",
    "hasAcceptedTerms": true,
    "aipriseUserVerificationSessionUrl": "https://verify-sandbox.aiprise.com/verification_session_id=bb321d1a-8037-44bf-a520-c9e2995fbb4d"
  },
  "businessData": {
    "businessName": "Company Name"
  },
  "individualData": {
    "firstName": "Name",
    "middleName": "Middle Name",
    "lastName": "Name",
    "secondLastName": "Last Name"
  },
  "id": "6877fc83509bb1423ee38202"
}

This endpoint should only be called for users in Mexico and Peru. For US users, terms and conditions must be accepted through the link returned by the create user by link endpoint.

Authorizations

x-api-key

string

header

required

Path Parameters

string<mongoId>

required

ID of the user.

Example:

"66562bc04fe8bf83c577c178"

Response

platformFeeRanges

object

Show child attributes

platformFeeRanges.MX

object

Show child attributes

platformFeeRanges.MX.buy

object[]

platformFeeRanges.MX.sell

object[]

platformFeeRanges.US

object

Show child attributes

platformFeeRanges.US.buy

object[]

platformFeeRanges.US.sell

object[]

platformFeeRanges.PE

object

Show child attributes

platformFeeRanges.PE.buy

object[]

platformFeeRanges.PE.sell

object[]

platformFeeRanges.CO

object

Show child attributes

platformFeeRanges.CO.buy

object[]

platformFeeRanges.CO.sell

object[]

createdAt

string

Creation date of the user.

Example:

"2025-07-16T19:24:51.284Z"

type

string

Type of the user.

Example:

"business"

phoneNumber

string

Phone number of the user.

Example:

"+525561310992"

string

Email of the user.

Example:

"[email protected]"

attributes

string[]

User attributes

Example:

["broker"]

address

object

Show child attributes

address.street1

string

Street 1 of the user's address.

Example:

"Amsterdam 76"

address.street2

string | null

Street 2 of the user's address.

Example:

null

address.city

string

City of the user's address.

Example:

"Mexico City"

address.state

string

State of the user's address.

Example:

"CDMX"

address.country

string

Country of the user's address.

Example:

"MX"

address.postalCode

string

Postal code of the user's address.

Example:

"06100"

brokerId

string

ID of the broker.

Example:

"6757546b4c5d19bf3cd7b09c"

onboarding

object

Show child attributes

onboarding.country

string

Country of the user's address.

Example:

"MX"

onboarding.status

string

Onboarding status.

Example:

"review"

onboarding.hasAcceptedTerms

boolean

Indicates if the user has accepted the terms and conditions.

Example:

true

onboarding.aipriseUserVerificationSessionUrl

string

AiPrise verification session URL (for individual users only).

Example:

"https://verify-sandbox.aiprise.com/verification_session_id=bb321d1a-8037-44bf-a520-c9e2995fbb4d"

businessData

object

Business data (for business users only).

Show child attributes

businessData.businessName

string

Business name.

Example:

"Company Name"

individualData

object

Individual data (for individual users only).

Show child attributes

individualData.firstName

string

First name of the user.

Example:

"Name"

individualData.middleName

string

Middle name of the user.

Example:

"Middle Name"

individualData.lastName

string

Last name of the user.

Example:

"Name"

individualData.secondLastName

string

Second last name of the user.

Example:

"Last Name"

string

ID of the user.

Example:

"6877fc83509bb1423ee38202"

Create a new user by link Add additional information to a user

⌘I

API Documentation

API List

Accept terms and conditions for a user

Authorizations

Path Parameters

Response