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

# Get the terms

> The terms the user has to accept for this onboarding: the text and/or page to show them, the `version` to send back when they accept, and whether they already have. `required` is false when the product asks for no terms.



## OpenAPI

````yaml api-reference/users-docs.json GET /api/users/{id}/onboarding/{productCode}/terms
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/{id}/onboarding/{productCode}/terms:
    get:
      tags:
        - Onboarding
      summary: Get the terms
      description: >-
        The terms the user has to accept for this onboarding: the text and/or
        page to show them, the `version` to send back when they accept, and
        whether they already have. `required` is false when the product asks for
        no terms.
      parameters:
        - $ref: '#/components/parameters/userIdPathParameter'
        - $ref: '#/components/parameters/productCodePathParameter'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/onboardingTermsSchema'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notFoundErrorSchema'
          description: Not Found
components:
  parameters:
    userIdPathParameter:
      name: id
      in: path
      required: true
      description: ID of the user.
      schema:
        type: string
        format: mongoId
        example: 66562bc04fe8bf83c577c178
    productCodePathParameter:
      name: productCode
      in: path
      required: true
      description: >-
        The product and country the onboarding is for, e.g. `stablecoin-fx-pe`
        (see GET /api/users/products).
      schema:
        type: string
        example: stablecoin-fx-pe
  schemas:
    onboardingTermsSchema:
      type: object
      properties:
        productCode:
          type: string
          description: 'The product in a country: product id, then country, lowercase.'
          example: stablecoin-fx-pe
        required:
          type: boolean
          description: >-
            False when the product asks for no terms; accepting is then
            optional.
        version:
          type: string
          description: Send it back when the user accepts. Changes when the terms change.
          example: 6689343a7bf5dffb
        url:
          type: string
          description: Page with the full terms, when there is one.
          example: https://rio.trade/terms
        label:
          type: string
          example: Stablecoin FX terms
        text:
          type: string
          description: The terms text (Markdown) to show, when there is one.
        accepted:
          type: boolean
        acceptedAt:
          type: string
          format: date-time
    notFoundErrorSchema:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                type: integer
                example: 1
              message:
                type: string
                example: User not found
            required:
              - code
              - message
      required:
        - errors
  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.