Ricoh USA

aid: ricoh-usa
url: https://raw.githubusercontent.com/api-evangelist/ricoh-usa/refs/heads/main/apis.yml
name: Ricoh USA
type: Index
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/ricoh-usa.png
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-07-25'
specificationVersion: '0.19'
apis:
- 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-images.s3.amazonaws.com/shared/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: SDKs
    url: https://github.com/ricohapi/theta-ble-client
- 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-images.s3.amazonaws.com/shared/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
- 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-images.s3.amazonaws.com/shared/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
- aid: ricoh-usa:ricoh-usa-protocol-api
  name: Ricoh USA Protocol API
  description: Core OSC protocol endpoints
  humanURL: https://docs-theta-api.ricoh360.com/web-api/
  baseURL: http://192.168.1.1
  tags:
  - Protocol
  properties:
  - type: OpenAPI
    url: openapi/ricoh-usa-protocol-api-openapi.yml
  - 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: 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
common:
- type: AgenticAccess
  url: agentic-access/ricoh-usa-agentic-access.yml
- type: DomainSecurity
  url: security/ricoh-usa-domain-security.yml
- 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: SDKs
  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
- type: Contact
  url: https://www.ricoh-usa.com/en/services-and-solutions
maintainers:
- FN: API Evangelist
  email: info@apievangelist.com