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



## OpenAPI

````yaml api-reference/users-docs.json GET /api/users/products
openapi: 3.0.0
info:
  version: v2.0.0
  title: Users API
  description: >-
    API for managing users in the Rio platform. A user is created for a product
    code (see GET /api/users/products) and has one onboarding per product code
    under /api/users/{id}/onboarding/{productCode}: send answers, documents and
    the terms acceptance, then submit it for review. Errors are `{ errors: [{
    code, message }] }`; a 503 means a dependency was briefly unavailable and
    nothing changed, so the same call can be retried; a 429 means the request
    allowance was used (see the RateLimit headers); a 409 on submit lists what
    is still missing.
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.