specification: API Commons Rate Limits
specificationVersion: '0.1'
schema: https://raw.githubusercontent.com/api-evangelist/interface-research/main/schema/api-commons.yml#/$defs/RateLimits
provider: Oracle Fusion Cloud Applications
providerId: oracle-fusion
created: '2026-05-04'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-04, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-05'
reconciled: false
tags:
  - Cloud
  - ERP
  - HCM
  - Oracle Cloud
  - Rate Limiting
  - SaaS
description: >-
  Oracle Fusion Cloud Applications REST APIs do not publish per-second or
  per-minute rate-limit numbers in the public REST API guides. Throughput is
  governed by the underlying Fusion Applications service pod capacity, by
  per-resource page-size limits, and by Fusion Common's authentication and
  session controls. Customers experiencing throttling are directed to Oracle
  Support to raise capacity via a service request, often coupled with a
  recommendation to switch to bulk-data patterns (FBDI, BI Publisher) for
  high-volume integrations.
sources:
  - https://docs.oracle.com/en/cloud/saas/
  - https://docs.oracle.com/en/cloud/saas/applications-common/
notes: >-
  Oracle does not publish per-tenancy RPS/RPM numbers for Fusion REST APIs.
  Set reconciled to true after capturing tenancy-specific values from a Fusion
  Applications service request response.
responseCodes:
  unauthorized: 401
  forbidden: 403
  notFound: 404
  serverError: 500
  serviceUnavailable: 503
limits:
  - name: REST API Throughput
    scope: tenancy
    metric: varies
    limit: bound by Fusion Applications service pod capacity
    notes: >-
      No public per-tenancy rate is published; throughput is governed by the
      underlying Fusion Applications pod and may be raised via an Oracle
      Support service request.
  - name: Bulk REST Page Size
    scope: request
    metric: rows_per_request
    limit: 500
    notes: >-
      Default Fusion REST API page size is 25 rows, configurable up to 500 via
      the limit query parameter for List operations.
  - name: REST Document Upload
    scope: request
    metric: payload_size_bytes
    limit: see Fusion REST API guide
    notes: Document attachment endpoints enforce per-file size limits documented per resource.
policies:
  - name: Backoff Strategy
    description: >-
      Clients should implement exponential backoff with jitter on 5xx
      responses; honor any Retry-After header when present.
  - name: Pagination
    description: >-
      Use the limit and offset query parameters and follow self/next links
      rather than issuing parallel large List operations.
  - name: Capacity Adjustment
    description: >-
      Sustained high-volume integrations should be coordinated through Oracle
      Support; tenancies on dedicated pods can request capacity increases.
  - name: Bulk Data Patterns
    description: >-
      For high-volume integrations prefer the BI Publisher bulk extract or
      File-Based Data Import (FBDI) over hitting transactional REST endpoints.
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com