API Reference

curl -X POST "http://149.102.159.66:8000/auth/login" \
  -H "Content-Type: text/plain" \
  -H "Accept: text/plain" \
  -d 'email:"user@example.com"
password:"yourpassword123"'

access_token:"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
token_type:"bearer"
user_type:"standard"
roles:["user"]

curl -X POST "http://149.102.159.66:8000/users/register" \
  -H "Content-Type: text/plain" \
  -H "Accept: text/plain" \
  -d 'first_name:"John"
last_name:"Doe"
email:"john.doe@example.com"
password:"securepassword123"'

message:"User registered successfully"
user:{
  id:"uuid-xxx-xxx"
  email:"john.doe@example.com"
  first_name:"John"
  last_name:"Doe"
  api_key:"ak_xxxxxxxxxxxxxx"
}

curl -X POST "http://149.102.159.66:8000/auth/logout" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

message:"Logged out successfully"

curl -X GET "http://149.102.159.66:8000/users/profile" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Accept: text/plain"

id:"uuid-xxx-xxx"
email:"john.doe@example.com"
first_name:"John"
last_name:"Doe"
api_key:"ak_xxxxxxxxxxxxxxxxxxxxxx"
user_type:"standard"
roles:["user"]
created_at:"2025-01-20T10:30:00Z"

curl -X GET "http://149.102.159.66:8000/v1/requests/req_abc123xyz" \
  -H "X-API-Key: YOUR_API_KEY"

request_id:"req_abc123xyz"
status:"completed"
processing_time_ms:2500
result_data:{
  invoice_number:"INV-2025-001"
  vendor_name:"ABC Supplies Co."
  date:"2025-01-20"
  total_amount:1250.00
  currency:"USD"
  line_items:[
    {description:"Office Supplies" quantity:10 unit_price:50.00 amount:500.00}
    {description:"Paper" quantity:5 unit_price:150.00 amount:750.00}
  ]
}

curl -X POST "http://149.102.159.66:8000/v1/voice/text-to-speech" \
  -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: text/plain" \
  -d 'text:"Hello, this is a text to speech demo."
language:"en"'

audio:"UklGRiQA..." (base64 encoded audio)
mimeType:"audio/mpeg"
duration:"2.5s"
processing_time:"0.8s"
model:"tts-1"
voice:"default"

curl -X POST "http://149.102.159.66:8000/v1/voice/speech-to-text" \
  -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxx" \
  -F "audio=@/path/to/recording.wav"

text:"This is the transcribed text from the audio file."
language:"en"
confidence:0.95
duration:"5.2s"
processing_time:"1.2s"
model:"whisper"

curl -X GET "http://149.102.159.66:8000/v1/history/documents?page=1&page_size=10&document_type=BankStatement" \
  -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxx"

total:70
page:1
page_size:10
document_type_filter:"BankStatement"
items:[
  {
    request_id:"req_abc123"
    document_type:"BankStatementPDF"
    original_filename:"statement.pdf"
    file_size_bytes:54022
    status:"COMPLETED"
    submitted_at:"2025-01-23T06:23:11Z"
    completed_at:"2025-01-23T06:23:20Z"
    processing_duration_ms:5487
    is_success:true
    summary:{
      document_type:"bank_statement"
      extraction_confidence:0.95
      opening_balance:1500.00
      closing_balance:2350.00
      transaction_count:15
    }
    processing_result:{...full extraction data...}
  }
]
stats:{
  total_requests:70
  completed_requests:65
  failed_requests:5
  avg_processing_time_ms:3500
  total_data_processed_bytes:5242880
}

curl -X GET "http://149.102.159.66:8000/v1/history/speech-to-text?page=1&page_size=10" \
  -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxx"

total:25
page:1
page_size:10
voice_type:"speech-to-text"
items:[
  {
    log_id:123
    request_id:"stt_abc123"
    endpoint:"speech-to-text"
    access_timestamp:"2025-01-23T10:30:00Z"
    is_success:true
    http_status_code:200
    latency_ms:1500
    processing_time_ms:1200
    file_size_bytes:256000
    input_data:{
      filename:"recording.wav"
      language:"en"
    }
    output_data:{
      text:"Transcribed text from audio..."
      confidence:0.95
    }
  }
]
stats:{
  total_requests:25
  successful_requests:23
  failed_requests:2
  avg_latency_ms:1400
}

curl -X GET "http://149.102.159.66:8000/v1/history/text-to-speech?page=1&page_size=10" \
  -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxx"

total:18
page:1
page_size:10
voice_type:"text-to-speech"
items:[
  {
    log_id:456
    request_id:"tts_xyz789"
    endpoint:"text-to-speech"
    access_timestamp:"2025-01-23T11:00:00Z"
    is_success:true
    http_status_code:200
    latency_ms:800
    processing_time_ms:600
    input_data:{
      text:"Hello, this is a test."
      language:"en"
    }
    output_data:{
      mimeType:"audio/mpeg"
      duration:"2.5s"
    }
  }
]
stats:{
  total_requests:18
  successful_requests:17
  failed_requests:1
  avg_latency_ms:750
}

curl -X GET "http://149.102.159.66:8000/v1/history/summary" \
  -H "X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxx"

document_processing:{
  by_type:{
    BankStatementPDF:25
    BankStatementImage:10
    ReceiptPDF:30
    InvoicePDF:15
  }
  total:80
  categories:{
    bank_statements:35
    receipts:30
    invoices:15
  }
}
voice_processing:{
  by_type:{
    speech-to-text:25
    text-to-speech:18
  }
  total:43
  speech_to_text:25
  text_to_speech:18
}
total_requests:123
last_request_at:"2025-01-23T11:30:00Z"

curl -X GET "http://149.102.159.66:8000/health"

status:"healthy"
timestamp:"2025-01-27T12:00:00Z"
version:"1.0.0"
uptime_seconds:86400