User

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/motaword/json-schema/motaword-user-schema.json",
  "title": "User",
  "x-generated": "2026-10-28",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/motaword-api-openapi.yml#/components/schemas/User",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "format": "int64"
    },
    "name": {
      "type": "string"
    },
    "first_name": {
      "type": "string"
    },
    "last_name": {
      "type": "string"
    },
    "has_pwd": {
      "type": "boolean"
    },
    "locale": {
      "type": "string",
      "description": "User Locale"
    },
    "timezone": {
      "type": "string"
    },
    "do_not_contact": {
      "type": "boolean"
    },
    "corporate_id": {
      "type": "integer",
      "format": "int64"
    },
    "is_client": {
      "type": "boolean"
    },
    "is_developer": {
      "type": "boolean"
    },
    "is_vendor": {
      "type": "boolean"
    },
    "vendor": {
      "type": "object",
      "properties": {
        "profile_survey": {
          "type": "object",
          "description": "Vendor Profile Survey answers",
          "$ref": "#/$defs/ProfileSurvey"
        },
        "id": {
          "type": "integer",
          "format": "int64"
        },
        "native_language": {
          "type": "string",
          "description": "Native language of user"
        },
        "can_work_manual_files": {
          "type": "boolean"
        },
        "is_frozen": {
          "type": "boolean"
        },
        "is_proofreader": {
          "type": "boolean"
        },
        "language_pairs": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/LanguagePair"
          }
        },
        "pam_tqs": {
          "type": "number",
          "format": "float"
        },
        "vendor_type": {
          "type": "string"
        },
        "vendor_types": {
          "description": "Modern permission-derived capability set — translator / proofreader\n/ interpreter, any subset. Prefer this over `vendor_type` (which is\nthe legacy single-value collapse kept for backward compatibility).\n",
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "translator",
              "proofreader",
              "interpreter"
            ]
          }
        },
        "account_status": {
          "description": "Domain-level account state the React VendorAccountAlert banner conditions on.",
          "type": "string"
        },
        "email_open_rate": {
          "type": "number",
          "format": "float"
        },
        "resume_file_name": {
          "description": "Filename (not path) of the resume currently on file. Empty / omitted when no resume is uploaded. Use this to decide whether to show \"Upload resume\" vs \"Replace resume\" on the UI.",
          "type": "string"
        },
        "profile_completed": {
          "description": "True when the vendor has answered all required profile survey questions (see VendorProfileSurvey::VENDOR_PROFILE_REQUIRED_FIELDS).",
          "type": "boolean"
        },
        "translator_agreement_pending": {
          "description": "True when the vendor has not consented to the latest translator-agreement version. The React dashboard renders a blocking re-consent modal on every page when this is true.",
          "type": "boolean"
        }
      }
    },
    "client": {
      "type": "object",
      "properties": {
        "corporate": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "format": "int64"
            },
            "name": {
              "type": "string"
            },
            "logo": {
              "type": "string"
            },
            "ask_additional_docs": {
              "type": "boolean"
            }
          }
        },
        "nps": {
          "type": "number",
          "format": "float"
        },
        "subjects": {
          "type": "object",
          "additionalProperties": {
            "type": "integer",
            "format": "int64"
          }
        }
      }
    },
    "status": {
      "type": "string"
    },
    "created_at": {
      "description": "Unix epoch time",
      "type": "integer",
      "format": "int64"
    },
    "last_seen_online_at": {
      "description": "Unix epoch time",
      "type": "integer",
      "format": "int64"
    },
    "profile_picture_path": {
      "type": "string"
    },
    "user_groups": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/UserGroup"
      }
    },
    "native_language": {
      "deprecated": true,
      "type": "string",
      "description": "\\@deprecated. Native language of user"
    },
    "can_work_manual_files": {
      "deprecated": true,
      "description": "\\@deprecated. use `vendor` key",
      "type": "boolean"
    },
    "is_proofreader": {
      "deprecated": true,
      "description": "\\@deprecated. use `vendor` key",
      "type": "boolean"
    },
    "language_pairs": {
      "deprecated": true,
      "description": "\\@deprecated. use `vendor` key",
      "type": "array",
      "items": {
        "$ref": "#/$defs/LanguagePair"
      }
    },
    "project_count": {
      "type": "integer",
      "format": "int64"
    },
    "admin_id": {
      "type": "integer",
      "format": "int64"
    },
    "links": {
      "$ref": "#/$defs/UserLinks"
    }
  },
  "$defs": {
    "Href": {
      "type": "object",
      "properties": {
        "href": {
          "type": "string"
        }
      }
    },
    "LanguagePair": {
      "type": "object",
      "properties": {
        "source_language": {
          "type": "string"
        },
        "target_language": {
          "type": "string"
        }
      }
    },
    "LinksMeta": {
      "type": "object",
      "properties": {
        "self": {
          "$ref": "#/$defs/Href"
        }
      }
    },
    "ProfileSurvey": {
      "type": "object",
      "properties": {
        "experience": {
          "type": "string"
        },
        "daily_translation_capacity": {
          "type": "string"
        },
        "daily_proofreading_capacity": {
          "type": "string"
        },
        "translator_association": {
          "type": "string"
        },
        "is_certified_translator": {
          "type": "string"
        },
        "is_sworn_translator": {
          "type": "string"
        },
        "proofreader_experience": {
          "type": "string"
        },
        "current_services": {
          "type": "string"
        },
        "sdl_trados": {
          "type": "string"
        },
        "memoq": {
          "type": "string"
        },
        "memsource": {
          "type": "string"
        },
        "smartling": {
          "type": "string"
        },
        "smartcat": {
          "type": "string"
        },
        "subtitle_edit": {
          "type": "string"
        },
        "subtitle_workshop": {
          "type": "string"
        },
        "wordbee": {
          "type": "string"
        },
        "xtm": {
          "type": "string"
        },
        "transsuite_2000": {
          "type": "string"
        },
        "xbench": {
          "type": "string"
        },
        "wordfast": {
          "type": "string"
        },
        "omegat": {
          "type": "string"
        },
        "dtp_software": {
          "type": "string"
        },
        "software": {
          "type": "string"
        },
        "working_timezone": {
          "type": "string"
        },
        "specialization": {
          "type": "string"
        },
        "work_with": {
          "type": "string"
        },
        "work_type": {
          "type": "string"
        },
        "working_as": {
          "type": "string"
        },
        "vendor_profile_lsp": {
          "type": "string"
        },
        "reference": {
          "type": "string",
          "description": "JSON-encoded array of references — `[{ fullName, organization, jobTitle, email, phone, relationship }]`, up to 3 entries."
        },
        "skype_id": {
          "type": "string"
        },
        "interpreter_experience_years": {
          "type": "string"
        },
        "dialect_specifications": {
          "type": "string"
        },
        "interpretation_specialization": {
          "type": "string"
        },
        "has_security_clearance": {
          "type": "string"
        },
        "security_clearance_level": {
          "type": "string"
        },
        "availability": {
          "type": "string"
        },
        "geographic_coverage": {
          "type": "string"
        },
        "device_type": {
          "type": "string"
        },
        "operating_system": {
          "type": "string"
        },
        "has_webcam": {
          "type": "string"
        },
        "has_noise_canceling_headset": {
          "type": "string"
        },
        "internet_connection_type": {
          "type": "string"
        },
        "download_speed": {
          "type": "string"
        },
        "video_platforms": {
          "type": "string"
        },
        "work_authorization_status": {
          "type": "string"
        },
        "certifications": {
          "type": "string",
          "description": "JSON-encoded array of certifications — `[{ name, nameOther, issuingOrganization, certificationNumber, issueDate, expirationDate, certificateFile }]`. `certificateFile` is the stored filename from POST /vendor/certificate-file."
        },
        "professional_bio": {
          "type": "string",
          "description": "Plain-text professional bio / experience summary shown on the vendor profile. 100-1000 chars enforced on the frontend."
        },
        "background_check_consent": {
          "type": "string",
          "description": "Legal & Agreements consent — `yes` once the vendor agrees to the background check."
        },
        "subcontractor_agreement": {
          "type": "string",
          "description": "Legal & Agreements consent — `yes` once the vendor agrees to the subcontractor terms."
        },
        "confidentiality_agreement": {
          "type": "string",
          "description": "Legal & Agreements consent — `yes` once the vendor agrees to the confidentiality terms."
        },
        "electronic_signature": {
          "type": "string",
          "description": "Vendor's typed legal name, used as the electronic signature on the Legal & Agreements step."
        },
        "signature_date": {
          "type": "string",
          "description": "Date the Legal & Agreements step was signed. Auto-stamped on save."
        }
      }
    },
    "UserGroup": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int64"
        },
        "name": {
          "type": "string"
        },
        "corporate_id": {
          "type": "integer",
          "format": "int64"
        },
        "permissions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "UserLinks": {
      "allOf": [
        {
          "$ref": "#/$defs/LinksMeta"
        },
        {
          "type": "object",
          "properties": {
            "stats": {
              "$ref": "#/$defs/Href"
            },
            "responsivity": {
              "description": "vendor users only",
              "$ref": "#/$defs/Href"
            },
            "projects": {
              "description": "client users only",
              "$ref": "#/$defs/Href"
            },
            "login_as": {
              "description": "Exculusive users only",
              "$ref": "#/$defs/Href"
            }
          }
        }
      ]
    }
  }
}