Ricoh USA is the United States operating company of Ricoh Co., Ltd. — a global imaging, printing, document services, and workplace technology vendor. Beyond its printer / MFP and managed document services portfolio, Ricoh exposes developer surfaces under three umbrellas: (1) Ricoh Smart Integration, a cloud workflow platform that connects MFPs to cloud storage and processing services; (2) RICOH360, a developer platform with a Cloud API for managing 360-degree spatial imagery; and (3) the open RICOH THETA Web / Bluetooth / USB APIs that control THETA 360 cameras directly. The THETA APIs and SDKs are published openly on GitHub; Ricoh360 Cloud API access is gated behind application approval; the older Ricoh Smart Integration developer endpoints (smartintegrationapi.com / api.smartintegrationapi.com) are not currently publicly reachable.
URL: Visit APIs.json URL
Run: Capabilities Using Naftiko
- Printing, Document Management, Workplace Services, Imaging, 360 Cameras, Workflow Automation
- Created: 2026-05-23
- Modified: 2026-05-23
HTTP-over-Wi-Fi API for controlling RICOH THETA 360 cameras (Z1, X, A1). Conforms to the Open Spherical Camera (OSC) API Level 2 specification by Google, with Ricoh vendor extensions. Exposes a small set of protocol endpoints (/osc/info, /osc/state, /osc/commands/execute, /osc/commands/status) plus a catalog of 26+ OSC commands such as camera.takePicture, camera.startCapture, camera.listFiles, camera.getOptions, camera.setOptions, and plugin-control commands.
Human URL: https://docs-theta-api.ricoh360.com/web-api/
Base URL: http://192.168.1.1 (camera in access-point mode)
- Documentation
- Getting Started
- Source Spec (GitHub)
- OpenAPI
- Spectral Rules
- Capability — Camera Control
- Capability — Media Management
GATT-based Bluetooth Low Energy API for controlling RICOH THETA cameras (V, Z1, X, A1). Built on Bluetooth 4.2 Core Specifications with Ricoh-specific service and characteristic extensions for shutter control, status reporting, camera information, and Wi-Fi pairing handoff.
Human URL: https://docs-theta-api.ricoh360.com/bluetooth-api/
MTP (Media Transfer Protocol v1.1) based USB API for controlling RICOH THETA cameras tethered over USB. Uses standard MTP operations with Ricoh-proprietary extensions for live preview, plugin management, and 360 metadata access.
Human URL: https://docs-theta-api.ricoh360.com/usb-api/
Hosted REST API for capture, upload, sharing, and management of 360-degree imagery from RICOH THETA and partner spherical cameras. Provides serverless image processing, AI-powered editing, virtual tour creation, archiving, and bulk device administration. API access requires application approval — no self-service signup.
Human URL: https://www.ricoh360.com/developer/
Cloud workflow platform that connects Ricoh multifunction printers and Smart Operation Panel devices to cloud storage (Box, Dropbox, Google Drive, OneDrive, SharePoint), document conversion (OCR / PDF), and Microsoft 365 / email distribution workflows. Previously exposed a documented developer API surface at smartintegrationapi.com; those endpoints currently refuse public connections, so partner / SI integrations route through Ricoh USA professional services.
Human URL: https://www.ricoh-usa.com/en/services-and-solutions
- Website
- Parent Website
- GitHub Organization (ricohapi)
- Developer Portal
- Documentation
- Support
- Contact Sales
- Case Studies
| Name | Description |
|---|---|
| 360-Degree Camera Control | Open OSC, Bluetooth, and USB APIs for controlling THETA spherical cameras programmatically |
| Cloud Image Processing | RICOH360 Cloud API performs AI-assisted 360 image conversion, stitching, blur, and tour creation |
| MFP Workflow Integration | Ricoh Smart Integration connects multifunction printers to cloud storage and document workflows |
| Multi-Language SDKs | THETA Client SDKs cover Android (Kotlin), iOS (Swift), React Native, and Flutter |
| Plugin Architecture | RICOH THETA plug-in SDK enables custom Android-based applications running on the camera |
| Spherical Metadata | IMU / GNSS sensor metadata embedded in JPG and MP4 outputs for spatial reconstruction |
| Bulk Device Management | RICOH360 Cloud API supports firmware updates and configuration of fleets of THETA cameras |
| Live Preview Streaming | Web API getLivePreview and USB UVC paths expose real-time spherical preview frames |
| Name | Description |
|---|---|
| Virtual Tours | Capture and publish 360-degree walkthroughs for real estate, construction, and retail |
| Construction Progress Documentation | Periodic 360 captures uploaded to RICOH360 Cloud for site audit and dispute resolution |
| Insurance Inspection | Field adjusters capture spherical scene evidence and sync to claim systems |
| Live Event Streaming | THETA plug-ins (WebRTC, Live Streaming) for 360 broadcasts |
| Scan-to-Cloud Workflows | Smart Integration sends MFP scans directly to Box, Google Drive, OneDrive, or SharePoint |
| Mobile Capture Apps | React Native / Flutter THETA Client apps for field-team capture pipelines |
| Asset Management | Catalog and search large libraries of 360 images via RICOH360 Cloud |
| Process Automation | Ricoh USA professional services build OCR / approval workflows around Smart Integration |
| Name | Description |
|---|---|
| Box | Smart Integration supports scan-to-Box workflows |
| Dropbox | Scan-to-cloud target via Smart Integration |
| Google Drive | Scan-to-cloud target via Smart Integration |
| Microsoft OneDrive | Scan-to-cloud target via Smart Integration |
| Microsoft SharePoint | Scan-to-cloud target via Smart Integration |
| Microsoft 365 / Outlook | Email distribution and routing from MFP scans |
| Salesforce | RICOH360 Cloud customer integrations for service / inspection workflows |
ricohapi — 51 repositories total. Notable active repos:
- theta-api-specs — canonical THETA API specifications (Web, Bluetooth, USB)
- theta-client — Kotlin Multiplatform SDK (Android, iOS, React Native, Flutter)
- theta-ble-client — Bluetooth SDK
- theta-plugin-sdk — Android-based plug-in SDK for THETA cameras
- theta-plugin-library — shared library for THETA plug-ins
- fake-theta — THETA API simulator for CI and development
- awesome-theta — curated community list
- libuvc-theta / libuvc-theta-sample — USB UVC live-preview support
A large historical set of ricoh-cloud-* and media-storage-* / auth-* SDKs sits archived in the same org (2023), reflecting an earlier generation of the Ricoh Cloud API that has since been superseded by RICOH360.
Machine-readable API specifications organized by format.
Naftiko capabilities organized as shared per-API definitions composed into customer-facing workflows.
- RICOH THETA Web API — 18 capabilities covering device info, state, commands, media, options, plug-ins, and network
- RICOH THETA Bluetooth API — 6 capabilities for GATT discover / shutter / Wi-Fi handoff
- RICOH THETA USB API — 7 capabilities for MTP / UVC operations
- RICOH360 Cloud API — 10 capabilities for upload, processing, tours, fleet management
| Workflow | APIs Combined | Persona |
|---|---|---|
| THETA Camera Control | RICOH THETA Web API | App Developer |
| THETA Media Management | RICOH THETA Web API | App Developer |
- Ricoh USA Vocabulary — Unified taxonomy across 5 APIs, 10 resources, capability domains (Camera Control, Media Management, Cloud Imagery, Virtual Tour, Fleet Administration, Document Workflow), and 4 personas
- THETA Web API Spectral Rules — Spectral rules enforcing OSC
/osc/path convention, POST-only command envelopes, Title Case summaries, camelCase operationIds, and standard description / response requirements
- Plans / Pricing — Free open device APIs (bundled with THETA hardware), enterprise-only RICOH360 Cloud and Smart Integration (contact sales)
- Rate Limits — Exclusive-use serialization on THETA (cameraInExclusiveUse error), contract-defined cloud quotas
- FinOps Mapping — Hardware CapEx for THETA, OpEx contracts for RICOH360 Cloud and Smart Integration
FN: Kin Lane
Email: kin@apievangelist.com