> ## 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.

# List the products you can onboard users for

> Each product is offered per country and named by a product code (`stablecoin-fx-mx`): the product, then the country, lowercase. A user is created for a product code and can start further onboardings for others. The list follows what compliance has published; check it rather than hard-coding codes.

> [!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](https://docs.rio.trade/introduction.md). To update an existing integration,
> follow the [migration guide](https://docs.rio.trade/migration.md).


## OpenAPI

````yaml v1/api-reference/users-docs.json GET /api/users/products
openapi: 3.0.0
info:
  version: v1.0.0
  title: Users API (legacy v1)
  description: API for managing users in the Rio platform
servers:
  - url: https://app.sandbox.rio.trade
security:
  - apiKeyAuth: []
paths:
  /api/users/products:
    get:
      tags:
        - Onboarding
      summary: List the products you can onboard users for
      description: >-
        Each product is offered per country and named by a product code
        (`stablecoin-fx-mx`): the product, then the country, lowercase. A user
        is created for a product code and can start further onboardings for
        others. The list follows what compliance has published; check it rather
        than hard-coding codes.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/productsResponseSchema'
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unauthorizedSchema'
          description: Unauthorized
components:
  schemas:
    productsResponseSchema:
      type: array
      description: >-
        The products you can onboard users for, one entry per product and
        country.
      items:
        type: object
        properties:
          productCode:
            type: string
            description: 'The product in a country: product id, then country, lowercase.'
            example: stablecoin-fx-pe
          name:
            type: string
            example: Stablecoin FX
          productId:
            type: string
            example: stablecoin-fx
          country:
            type: string
            description: ISO 3166-1 alpha-2.
            example: PE
          userTypes:
            type: array
            description: Account types the product is offered to.
            items:
              type: string
              enum:
                - business
                - individual
            example:
              - individual
    unauthorizedSchema:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                type: number
                example: 19
              message:
                type: string
                example: Not authorized
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

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