> ## Documentation Index > Fetch the complete documentation index at: https://docs.truust.io/llms.txt > Use this file to discover all available pages before exploring further. # Verify Account > Submits KYC (Know Your Customer) information for the authenticated account. Use `NATURAL` for individuals and `LEGAL` for companies. For `LEGAL` type, representative information is required. ## OpenAPI ````yaml POST /accounts/verify openapi: 3.1.0 info: title: Truust API version: '2.0' description: > The Truust API allows you to manage payment flows, orders, customers, wallets, and more. ## Authentication All authenticated endpoints require a Bearer token using your account's **Secret Key**. ``` Authorization: Bearer {your_secret_key} ``` Your API keys are available in the Dashboard under **Account Settings → API Developers**. contact: email: hello@truust.io license: name: Proprietary servers: - url: https://{subdomain}.truust.io/2.0 description: Production variables: subdomain: default: your-subdomain description: Your account subdomain - url: https://{subdomain}-sandbox.truust.io/2.0 description: Sandbox variables: subdomain: default: your-subdomain description: Your account subdomain security: - bearerAuth: [] tags: - name: Account description: Manage your Truust account - name: Customers description: Manage buyers and sellers (end users) - name: Orders description: Create and manage escrow payment orders - name: Payins description: Manage incoming payments for orders - name: Payouts description: Manage outgoing payments from orders - name: Wallets description: Manage customer and account wallets - name: Bank Accounts description: Manage bank accounts for payouts - name: Cards description: Manage tokenized payment cards - name: Subscriptions description: Manage recurring payment subscriptions - name: Verifications description: KYC verification for customers and accounts - name: Bundles description: Manage product bundles for orders - name: Refunds description: View refund records paths: /accounts/verify: post: tags: - Account summary: Verify account description: > Submits KYC (Know Your Customer) information for the authenticated account. Use `NATURAL` for individuals and `LEGAL` for companies. For `LEGAL` type, representative information is required. operationId: verifyAccount requestBody: required: true content: application/json: schema: type: object required: - type - first_name - last_name - vat_id - legal_address - legal_city - legal_zip - legal_state example: type: LEGAL first_name: John last_name: Doe vat_id: '123456789' legal_name: My Company SL legal_address: Llauder, 1 legal_city: Barcelona legal_zip: '08001' legal_state: Barcelona legal_country: ES representative_name: John Doe representative_email: support@mycompany.com representative_phone: '+34666999666' properties: type: type: string enum: - NATURAL - SOLETRADER - LEGAL description: >- Verification type: `NATURAL` for individuals, `SOLETRADER` for self-employed, `LEGAL` for companies. first_name: type: string maxLength: 255 description: First name of the account holder or representative. last_name: type: string maxLength: 255 description: Last name of the account holder or representative. vat_id: type: string maxLength: 255 description: Tax identification number (DNI, NIF, CIF, etc.). legal_name: type: string maxLength: 255 description: Company legal name. Required for `LEGAL` type. legal_address: type: string maxLength: 255 description: Legal registered address. legal_city: type: string maxLength: 255 legal_zip: type: string maxLength: 255 legal_state: type: string maxLength: 255 legal_country: type: string maxLength: 2 description: ISO 3166-1 alpha-2 country code. birthday: type: string format: date description: Date of birth. Applicable for `NATURAL` type. occupation: type: string maxLength: 255 description: >- Title or short description of occupation. Applicable for `NATURAL` type. income_range: type: number description: Income range value. Applicable for `NATURAL` type. representative_name: type: string maxLength: 255 description: >- Full name of the company representative. Required for `LEGAL` type. representative_email: type: string format: email description: >- Email of the company representative. Required for `LEGAL` type. representative_phone: type: string description: >- Phone of the company representative. Required for `LEGAL` type. responses: '200': description: Account verification submitted content: application/json: schema: $ref: '#/components/schemas/Account' '422': $ref: '#/components/responses/ValidationError' components: schemas: Account: type: object properties: self: type: string example: /2.0/accounts/me merchant_id: type: string description: Unique merchant identifier (addon_key). name: type: string example: My Company email: type: string format: email currency: type: string example: EUR country_code: type: string example: ES business_url: type: string nullable: true business_phone: type: string nullable: true business_description: type: string nullable: true image_url: type: string nullable: true public_key: type: string secret_key: type: string description: Secret API key. Only visible to the account owner. allow_shipping: type: integer enum: - 0 - 1 value_shipping: type: number is_active: type: boolean psd2_enabled: type: integer enum: - 0 - 1 allowed_gateways: type: array items: type: string gateways: type: array nullable: true items: type: object additionalProperties: true description: List of configured payment gateway objects for the account. default_gateway: type: string nullable: true created_at: type: string format: date-time nullable: true responses: ValidationError: description: Validation error content: application/json: schema: type: object properties: message: type: string example: The given data was invalid. errors: type: object additionalProperties: type: array items: type: string example: name: - The name field is required. securitySchemes: bearerAuth: type: http scheme: bearer description: Use your account's **Secret Key** as the Bearer token. ````