aid: ricoh-usa url: https://raw.githubusercontent.com/api-evangelist/ricoh-usa/refs/heads/main/apis.yml name: Ricoh USA type: Index image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg tags: - Printing - Document Management - Workplace Services - Imaging - 360 Cameras - Workflow Automation description: | 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. created: '2026-05-23' modified: '2026-05-23' specificationVersion: '0.19' apis: - aid: ricoh-usa:theta-web-api name: RICOH THETA Web API description: | 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. The device acts as an access point or client-mode peer. tags: - 360 Cameras - Imaging - OSC - Camera Control image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://docs-theta-api.ricoh360.com/web-api/ baseURL: http://192.168.1.1 properties: - type: Documentation url: https://docs-theta-api.ricoh360.com/web-api/ - type: GettingStarted url: https://ricoh360.notion.site/THETA-API-Guidance-2782875d3632434f9049a641de642142 - type: SourceSpec url: https://github.com/ricohapi/theta-api-specs/tree/main/theta-web-api-v2.1 - type: OpenAPI url: openapi/theta-web-api-openapi.yml - type: JSONSchema url: json-schema/theta-web-api-device-info-schema.json - type: JSONSchema url: json-schema/theta-web-api-camera-state-schema.json - type: JSONSchema url: json-schema/theta-web-api-command-execute-schema.json - type: JSONSchema url: json-schema/theta-web-api-file-entry-schema.json - type: JSONLD url: json-ld/ricoh-usa-context.jsonld - type: SpectralRules url: rules/theta-web-api-rules.yml - type: Examples url: examples/theta-web-api-take-picture-example.json - type: Examples url: examples/theta-web-api-list-files-example.json - type: Examples url: examples/theta-web-api-get-options-example.json - type: NaftikoCapability url: capabilities/theta-camera-control.yaml - type: NaftikoCapability url: capabilities/theta-media-management.yaml - type: NaftikoCapability url: capabilities/shared/theta-web-api.yaml - aid: ricoh-usa:theta-bluetooth-api name: RICOH THETA Bluetooth API description: | 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. tags: - 360 Cameras - Bluetooth - GATT - Camera Control image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://docs-theta-api.ricoh360.com/bluetooth-api/ properties: - type: Documentation url: https://docs-theta-api.ricoh360.com/bluetooth-api/ - type: SourceSpec url: https://github.com/ricohapi/theta-api-specs/tree/main/theta-bluetooth-api - type: SDK url: https://github.com/ricohapi/theta-ble-client - type: NaftikoCapability url: capabilities/shared/theta-bluetooth-api.yaml - aid: ricoh-usa:theta-usb-api name: RICOH THETA USB API description: | MTP (Media Transfer Protocol v1.1) based USB API for controlling RICOH THETA cameras (S and later, including Z1, X, A1) when tethered over USB. Uses standard MTP operations with Ricoh-proprietary extensions for live preview, plugin management, and 360 metadata access. tags: - 360 Cameras - USB - MTP - Camera Control image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://docs-theta-api.ricoh360.com/usb-api/ properties: - type: Documentation url: https://docs-theta-api.ricoh360.com/usb-api/ - type: SourceSpec url: https://github.com/ricohapi/theta-api-specs/tree/main/theta-usb-api - type: SampleCode url: https://github.com/ricohapi/libuvc-theta-sample - type: NaftikoCapability url: capabilities/shared/theta-usb-api.yaml - aid: ricoh-usa:ricoh360-cloud-api name: RICOH360 Cloud API description: | 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 (firmware updates, configuration). API access requires application approval through RICOH360 sales / developer contact — no self-service signup. tags: - 360 Cameras - Cloud - Image Processing - Spatial Data image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://www.ricoh360.com/developer/ properties: - type: Documentation url: https://docs.ricoh360.com/ - type: Portal url: https://www.ricoh360.com/developer/ - type: ContactSales url: https://link.ricoh360.com/contact - type: NaftikoCapability url: capabilities/shared/ricoh360-cloud-api.yaml - aid: ricoh-usa:smart-integration name: Ricoh Smart Integration description: | Cloud workflow platform that connects Ricoh multifunction printers (MFPs) and Smart Operation Panel devices to cloud storage (Box, Dropbox, Google Drive, OneDrive, SharePoint), document conversion (OCR / PDF), and Microsoft 365 / email distribution workflows. Branded "Always Current Technology" delivery model. Previously exposed a documented developer API surface at smartintegrationapi.com and api.smartintegrationapi.com; those endpoints currently refuse public connections, so partner / SI integrations route through Ricoh USA professional services rather than a self-service developer portal at this time. tags: - Workflow Automation - MFP - Document Management - Cloud Storage - OCR image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://www.ricoh-usa.com/en/services-and-solutions properties: - type: Marketing url: https://www.ricoh-usa.com/en/services-and-solutions - type: ContactSales url: https://www.ricoh-usa.com/en/support-and-download/contact-us common: - type: Website url: https://www.ricoh-usa.com/ - type: ParentWebsite url: https://www.ricoh.com/ - type: GitHubOrganization url: https://github.com/ricohapi - type: DeveloperPortal url: https://www.ricoh360.com/developer/ - type: Documentation url: https://docs.ricoh360.com/ - type: Support url: https://www.ricoh-usa.com/en/support-and-download - type: ContactSales url: https://www.ricoh-usa.com/en/support-and-download/contact-us - type: LinkedIn url: https://www.linkedin.com/company/ricoh-usa-inc- - type: Careers url: https://www.ricoh-usa.com/en/about-us/careers - type: CaseStudies url: https://www.ricoh-usa.com/en/insights/case-studies - type: Vocabulary url: vocabulary/ricoh-usa-vocabulary.yml - type: JSONLD url: json-ld/ricoh-usa-context.jsonld - type: Plans url: plans/ricoh-usa-plans-pricing.yml - type: RateLimits url: rate-limits/ricoh-usa-rate-limits.yml - type: FinOps url: finops/ricoh-usa-finops.yml - type: Features data: - name: 360-Degree Camera Control description: Open OSC, Bluetooth, and USB APIs for controlling THETA spherical cameras programmatically - name: Cloud Image Processing description: RICOH360 Cloud API performs AI-assisted 360 image conversion, stitching, blur, and tour creation - name: MFP Workflow Integration description: Ricoh Smart Integration connects multifunction printers to cloud storage and document workflows - name: Multi-Language SDKs description: THETA Client SDKs cover Android (Kotlin), iOS (Swift), React Native, and Flutter - name: Plugin Architecture description: RICOH THETA plug-in SDK enables custom Android-based applications running on the camera - name: Spherical Metadata description: IMU / GNSS sensor metadata embedded in JPG and MP4 outputs for spatial reconstruction - name: Bulk Device Management description: RICOH360 Cloud API supports firmware updates and configuration of fleets of THETA cameras - name: Live Preview Streaming description: Web API getLivePreview and USB UVC paths expose real-time spherical preview frames - type: UseCases data: - name: Virtual Tours description: Capture and publish 360-degree walkthroughs for real estate, construction, and retail - name: Construction Progress Documentation description: Periodic 360 captures uploaded to RICOH360 Cloud for site audit and dispute resolution - name: Insurance Inspection description: Field adjusters capture spherical scene evidence and sync to claim systems - name: Live Event Streaming description: Use THETA plug-ins (WebRTC, Live Streaming) for 360 broadcasts - name: Scan-to-Cloud Workflows description: Smart Integration sends MFP scans directly to Box, Google Drive, OneDrive, or SharePoint - name: Mobile Capture Apps description: React Native / Flutter THETA Client apps for field-team capture pipelines - name: Asset Management description: Catalog and search large libraries of 360 images via RICOH360 Cloud - name: Process Automation description: Ricoh USA professional services build OCR / approval workflows around Smart Integration - type: Integrations data: - name: Box description: Smart Integration supports scan-to-Box workflows - name: Dropbox description: Scan-to-cloud target via Smart Integration - name: Google Drive description: Scan-to-cloud target via Smart Integration - name: Microsoft OneDrive description: Scan-to-cloud target via Smart Integration - name: Microsoft SharePoint description: Scan-to-cloud target via Smart Integration - name: Microsoft 365 / Outlook description: Email distribution and routing from MFP scans - name: Salesforce description: RICOH360 Cloud customer integrations for service / inspection workflows - type: GitHub data: - name: ricohapi url: https://github.com/ricohapi description: Primary GitHub organization covering THETA APIs, SDKs, plug-in samples, and historical Ricoh Cloud SDKs repoCount: 51 notable: - theta-api-specs - theta-client - theta-ble-client - theta-plugin-sdk - awesome-theta - fake-theta - libuvc-theta-sample - type: SDK data: - name: theta-client (Kotlin Multiplatform) url: https://github.com/ricohapi/theta-client languages: - Kotlin - Swift - Dart (Flutter) - TypeScript (React Native) description: Cross-platform library for controlling RICOH THETA cameras over Wi-Fi - name: theta-ble-client url: https://github.com/ricohapi/theta-ble-client languages: - Kotlin description: Library for controlling RICOH THETA via Bluetooth - name: theta-plugin-sdk url: https://github.com/ricohapi/theta-plugin-sdk languages: - Java description: Android-based SDK for building plug-ins that run on RICOH THETA cameras - name: theta-plugin-library url: https://github.com/ricohapi/theta-plugin-library languages: - Java description: Shared library used by THETA plug-in samples and third-party plug-ins - type: Tools data: - name: fake-theta url: https://github.com/ricohapi/fake-theta description: THETA API simulator used for SDK development and CI - name: libuvc-theta url: https://github.com/ricohapi/libuvc-theta description: USB Video Class library fork supporting THETA over UVC - name: libuvc-theta-sample url: https://github.com/ricohapi/libuvc-theta-sample description: Sample code demonstrating 4K/2K live preview from THETA via USB - type: Samples data: - name: theta-plugin-camera-api-sample url: https://github.com/ricohapi/theta-plugin-camera-api-sample - name: theta-plugin-camera-api-sample-x url: https://github.com/ricohapi/theta-plugin-camera-api-sample-x - name: theta-automatic-face-blur-plugin url: https://github.com/ricohapi/theta-automatic-face-blur-plugin - name: theta-wireless-live-streaming-plugin url: https://github.com/ricohapi/theta-wireless-live-streaming-plugin - type: Capabilities data: - name: theta-camera-control url: capabilities/theta-camera-control.yaml description: End-to-end workflow capability for capturing and downloading THETA media - name: theta-media-management url: capabilities/theta-media-management.yaml description: Workflow capability for browsing, retrieving, and deleting media on a THETA device - name: shared/theta-web-api url: capabilities/shared/theta-web-api.yaml - name: shared/theta-bluetooth-api url: capabilities/shared/theta-bluetooth-api.yaml - name: shared/theta-usb-api url: capabilities/shared/theta-usb-api.yaml - name: shared/ricoh360-cloud-api url: capabilities/shared/ricoh360-cloud-api.yaml maintainers: - FN: API Evangelist email: info@apievangelist.com