openapi: 3.2.0
info:
  title: LegalEasy Chatgpt API
  description: API for analyzing legal documents and generating plain-English summaries with risk assessments
  version: 1.0.0
servers:
- url: https://policycheck.tools
tags:
- name: Chatgpt
paths:
  /api/chatgpt/analyze:
    post:
      operationId: analyzeLegalDocument
      summary: Analyze a legal document
      description: Analyzes legal text (terms of service, privacy policy, etc.) and returns a structured summary with risk assessment. Identifies key clauses like arbitration, liability caps, data sharing, and categorizes risks.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - text
              properties:
                text:
                  type: string
                  description: The full text of the legal document to analyze. Can be terms of service, privacy policy, refund policy, or any legal document.
                document_type:
                  type: string
                  enum:
                  - terms
                  - privacy
                  - refund
                  - shipping
                  - other
                  description: Type of document being analyzed. Defaults to 'terms' if not specified.
                  default: terms
                product_name:
                  type: string
                  description: 'Optional: Name of the product/service (e.g., ''Zora'', ''Shopify''). Helps with context.'
      responses:
        '200':
          description: Successfully analyzed document
          content:
            application/json:
              schema:
                type: object
                properties:
                  summary:
                    type: object
                    properties:
                      product:
                        type: string
                        description: Name of the product/service
                      updated_at:
                        type: string
                        description: When the terms were last updated (ISO date)
                      jurisdiction:
                        type: array
                        items:
                          type: string
                        description: Governing jurisdiction(s)
                      sections:
                        type: array
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: Section identifier (e.g., 'disputes', 'liability', 'wallet')
                            title:
                              type: string
                              description: Human-readable section title
                            bullets:
                              type: array
                              items:
                                type: string
                              description: Key points in plain English
                            body:
                              type: string
                              description: Detailed explanation
                  risks:
                    type: object
                    properties:
                      arbitration:
                        type: boolean
                        description: Whether binding arbitration is required
                      classActionWaiver:
                        type: boolean
                        description: Whether class action lawsuits are waived
                      liabilityCap:
                        type:
                        - number
                        - 'null'
                        description: Maximum liability amount in dollars
                      terminationAtWill:
                        type: boolean
                        description: Whether account can be terminated at any time
                      optOutDays:
                        type:
                        - number
                        - 'null'
                        description: Number of days to opt out of arbitration
                  key_findings:
                    type: array
                    items:
                      type: string
                    description: Most important findings in plain English
        '400':
          description: Bad request - invalid input
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '500':
          description: Server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      tags:
      - Chatgpt
  /api/chatgpt/analyze-url:
    post:
      operationId: analyzeLegalDocumentFromURL
      summary: Analyze a legal document from a URL
      description: Fetches and analyzes a legal document from a given URL. Automatically extracts the main content and provides a structured summary with risk assessment.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - url
              properties:
                url:
                  type: string
                  description: URL of the legal document to analyze (e.g., 'https://example.com/terms', 'https://example.com/privacy')
                document_type:
                  type: string
                  enum:
                  - terms
                  - privacy
                  - refund
                  - shipping
                  - other
                  description: Type of document being analyzed. Auto-detected if not specified.
                  default: terms
      responses:
        '200':
          description: Successfully analyzed document from URL
          content:
            application/json:
              schema:
                type: object
                properties:
                  url:
                    type: string
                    description: The URL that was analyzed
                  title:
                    type: string
                    description: Page title
                  content_length:
                    type: number
                    description: Length of extracted content in characters
                  summary:
                    type: object
                    description: Same structure as /api/chatgpt/analyze response
                  risks:
                    type: object
                    description: Risk flags identified
                  key_findings:
                    type: array
                    items:
                      type: string
                    description: Most important findings
        '400':
          description: Bad request - invalid URL
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '500':
          description: Server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      tags:
      - Chatgpt