> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rio.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

<Warning>
  **v1 (legacy).** This page documents the API before the v2 update. The v1
  format is not enabled for new accounts and must be enabled on your account by
  your account manager. New integrations should use the
  [current documentation](/introduction). To update an existing integration,
  follow the [migration guide](/migration).
</Warning>

## Setting up

Here are some important things to keep in mind when integrating with our APIs.

We currently use OpenAPI 3.0 specification to specify and document our APIs, so it will be easy for you to make requests and observe the responses.

The first steps to start the integration process are defined below.

### <Icon icon="arrow-progress" iconType="solid" /> User account creation

<Note>
  **Disclaimer**: Sandbox environment is intended for testing purposes only.
  When creating user accounts or inputting data, feel free to use fake or dummy
  information to complete onboarding faster. No real user data is required or
  recommended in this environment.
</Note>

* Visit our test environment: [https://app.sandbox.rio.trade/en/register](https://app.sandbox.rio.trade/en/register)
* Create an account by entering a phone number, including the country code (Example: +520000000000).
* Set your password and security question.
* Once your registration is complete, log in to the platform using your registered credentials.

### <Icon icon="arrow-progress" iconType="solid" /> API key generation

After completing the registration process at [https://app.sandbox.rio.trade/en/register](https://app.sandbox.rio.trade/en/register), you must enter the application through [https://app.sandbox.rio.trade/en/login](https://app.sandbox.rio.trade/en/login) with the username and password assigned. Once on the platform, open your **user settings** and go to the **API keys** tab to generate the respective key.

This is an example of the request:

```
curl -X 'GET' \
  'https://app.sandbox.rio.trade/api/users' \
  -H 'accept: */*' \
  -H 'x-api-key: test'
```

<Note>
  Remember to use the API key generated in the request headers by adding the
  x-api-key.
</Note>

### <Icon icon="arrow-progress" iconType="solid" /> User approval

The user approval process is carried out by the system administrators. Therefore, when creating a user, the approval request must be made to the administrators through `Slack or email`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.