> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iotools.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Running Pace Calculator

> Solve the running pace triangle: enter any two of distance, time and pace to calculate the third. Shows pace per km and per mile, speed, a Riegel equivalent race-time predictor (5K, 10K, half, marathon and more) and an even-split table.

[Try Running Pace Calculator in your browser →](https://iotools.cloud/tool/running-pace-calculator/)



## OpenAPI

````yaml https://api.iotools.cloud/v1/openapi post /v1/tool/running-pace-calculator
openapi: 3.1.0
info:
  title: iotools.cloud API
  version: 1.0.0
  description: >-
    Run any iotools.cloud tool over HTTP.


    Authenticate with `Authorization: Bearer iot_live_…`.


    **Only `POST /v1/tool/{slug}` costs credits.** Every GET here — the catalog,
    a tool's schema, your balance — is free. A tool call is charged its own
    weight or your plan's per-call minimum, whichever is larger;
    `x-iotools-credit-cost` on each operation is quoted at the free-tier
    minimum, and `GET /v1/tools/list` returns the exact figure for your key.
    `GET /v1/me/credits` reports what you have left, and `GET /v1/me/usage`
    reports what it went on.


    Failures are RFC 9457 problem documents — branch on `code`.
servers:
  - url: https://api.iotools.cloud
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Catalog
    description: Find a tool and read its contract. Free.
  - name: Converters
    description: >-
      Convert between formats, encodings, and units — Base64, CSV and JSON,
      timestamps, and more. Fast, free, and processed right in your browser.
  - name: Formatters
    description: >-
      Format, beautify, minify, and validate code and data — JSON, HTML, CSS,
      SQL, and regex. Clean up messy input in one click, with nothing to upload.
  - name: Generators
    description: >-
      Generate exactly what you need and on demand — passwords, UUIDs, QR codes,
      hashes, random numbers, and more. Secure, instant, and free.
  - name: Calculators
    description: >-
      Crunch the numbers fast — from everyday math to specialized conversions
      and unit work. Free online calculators that run entirely in your browser.
  - name: Editors
    description: >-
      Edit and transform text, code, and images with quick, focused editors that
      run entirely in your browser — nothing to install, and no sign-up needed.
  - name: Utilities
    description: >-
      Everyday developer and web utilities — DNS and IP lookups, redirect and
      certificate checkers, and other quick diagnostics. Free and
      privacy-friendly.
  - name: Account
    description: Your key's allowance, limits and usage history.
paths:
  /v1/tool/running-pace-calculator:
    post:
      tags:
        - Calculators
      summary: Running Pace Calculator
      description: >-
        Solve the running pace triangle: enter any two of distance, time and
        pace to calculate the third. Shows pace per km and per mile, speed, a
        Riegel equivalent race-time predictor (5K, 10K, half, marathon and more)
        and an even-split table.


        [Try Running Pace Calculator in your browser
        →](https://iotools.cloud/tool/running-pace-calculator/)
      operationId: run_running_pace_calculator
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                mode:
                  enum:
                    - pace
                    - time
                    - distance
                  description: Calculate
                distancePreset:
                  enum:
                    - custom
                    - '1.609344'
                    - '5'
                    - '10'
                    - '15'
                    - '21.0975'
                    - '42.195'
                    - '50'
                    - '100'
                  description: Distance preset
                distance:
                  type: number
                  description: Distance
                  minimum: 0
                distanceUnit:
                  enum:
                    - km
                    - miles
                    - meters
                  description: Distance unit
                time:
                  type: string
                  description: Time
                pace:
                  type: string
                  description: Pace
                paceUnit:
                  enum:
                    - km
                    - mile
                  description: Pace unit
                splitUnit:
                  enum:
                    - km
                    - mile
                  description: Split every
              required: []
            examples:
              pace_from_10_km_in_50_00:
                summary: Pace from 10 km in 50:00
                value:
                  mode: pace
                  distancePreset: custom
                  distance: '10'
                  distanceUnit: km
                  time: '50:00'
                  splitUnit: km
              time_from_half_marathon_at_5_00_km:
                summary: Time from half marathon at 5:00/km
                value:
                  mode: time
                  distancePreset: '21.0975'
                  distanceUnit: km
                  pace: '5:00'
                  paceUnit: km
                  splitUnit: km
              distance_from_5_00_km_for_30_00:
                summary: Distance from 5:00/km for 30:00
                value:
                  mode: distance
                  distanceUnit: km
                  time: '30:00'
                  pace: '5:00'
                  paceUnit: km
                  splitUnit: km
              marathon_time_from_8_00_mile_pace_mile_splits:
                summary: Marathon time from 8:00/mile pace, mile splits
                value:
                  mode: time
                  distancePreset: '42.195'
                  distanceUnit: miles
                  pace: '8:00'
                  paceUnit: mile
                  splitUnit: mile
      responses:
        '200':
          description: Tool output
          content:
            application/json:
              examples:
                pace_from_10_km_in_50_00:
                  summary: Pace from 10 km in 50:00
                  value:
                    tool: running-pace-calculator
                    tool_version: 1.0.1
                    outputs:
                      summary:
                        - metric: Distance
                          value: 10.00 km
                        - metric: Total Time
                          value: '50:00'
                        - metric: Pace /km
                          value: 5:00 min/km
                        - metric: Pace /mile
                          value: 8:03 min/mi
                        - metric: Speed
                          value: 12.00 km/h
                        - metric: Speed (imperial)
                          value: 7.46 mph
                      equivalent:
                        - distance: 1 Mile
                          predicted-time: '7:13'
                          pace-km: 4:29 /km
                          pace-mile: 7:13 /mi
                        - distance: 5K
                          predicted-time: '23:59'
                          pace-km: 4:48 /km
                          pace-mile: 7:43 /mi
                        - distance: 10K
                          predicted-time: '50:00'
                          pace-km: 5:00 /km
                          pace-mile: 8:03 /mi
                        - distance: 15K
                          predicted-time: '1:16:51'
                          pace-km: 5:07 /km
                          pace-mile: 8:15 /mi
                        - distance: Half Marathon
                          predicted-time: '1:50:19'
                          pace-km: 5:14 /km
                          pace-mile: 8:25 /mi
                        - distance: Marathon
                          predicted-time: '3:50:01'
                          pace-km: 5:27 /km
                          pace-mile: 8:46 /mi
                        - distance: 50K Ultra
                          predicted-time: '4:35:21'
                          pace-km: 5:30 /km
                          pace-mile: 8:52 /mi
                        - distance: 100K Ultra
                          predicted-time: '9:34:05'
                          pace-km: 5:44 /km
                          pace-mile: 9:14 /mi
                      splits:
                        - split: km 1
                          split-time: '5:00'
                          cumulative: '5:00'
                        - split: km 2
                          split-time: '5:00'
                          cumulative: '10:00'
                        - split: km 3
                          split-time: '5:00'
                          cumulative: '15:00'
                        - split: km 4
                          split-time: '5:00'
                          cumulative: '20:00'
                        - split: km 5
                          split-time: '5:00'
                          cumulative: '25:00'
                        - split: km 6
                          split-time: '5:00'
                          cumulative: '30:00'
                        - split: km 7
                          split-time: '5:00'
                          cumulative: '35:00'
                        - split: km 8
                          split-time: '5:00'
                          cumulative: '40:00'
                        - split: km 9
                          split-time: '5:00'
                          cumulative: '45:00'
                        - split: km 10
                          split-time: '5:00'
                          cumulative: '50:00'
                    credits_used: 3
                    credits_remaining: null
                time_from_half_marathon_at_5_00_km:
                  summary: Time from half marathon at 5:00/km
                  value:
                    tool: running-pace-calculator
                    tool_version: 1.0.1
                    outputs:
                      summary:
                        - metric: Distance
                          value: 21.10 km
                        - metric: Total Time
                          value: '1:45:29'
                        - metric: Pace /km
                          value: 5:00 min/km
                        - metric: Pace /mile
                          value: 8:03 min/mi
                        - metric: Speed
                          value: 12.00 km/h
                        - metric: Speed (imperial)
                          value: 7.46 mph
                      equivalent:
                        - distance: 1 Mile
                          predicted-time: '6:54'
                          pace-km: 4:17 /km
                          pace-mile: 6:54 /mi
                        - distance: 5K
                          predicted-time: '22:56'
                          pace-km: 4:35 /km
                          pace-mile: 7:23 /mi
                        - distance: 10K
                          predicted-time: '47:49'
                          pace-km: 4:47 /km
                          pace-mile: 7:42 /mi
                        - distance: 15K
                          predicted-time: '1:13:29'
                          pace-km: 4:54 /km
                          pace-mile: 7:53 /mi
                        - distance: Half Marathon
                          predicted-time: '1:45:29'
                          pace-km: 5:00 /km
                          pace-mile: 8:03 /mi
                        - distance: Marathon
                          predicted-time: '3:39:56'
                          pace-km: 5:13 /km
                          pace-mile: 8:23 /mi
                        - distance: 50K Ultra
                          predicted-time: '4:23:17'
                          pace-km: 5:16 /km
                          pace-mile: 8:28 /mi
                        - distance: 100K Ultra
                          predicted-time: '9:08:56'
                          pace-km: 5:29 /km
                          pace-mile: 8:50 /mi
                      splits:
                        - split: km 1
                          split-time: '5:00'
                          cumulative: '5:00'
                        - split: km 2
                          split-time: '5:00'
                          cumulative: '10:00'
                        - split: km 3
                          split-time: '5:00'
                          cumulative: '15:00'
                        - split: km 4
                          split-time: '5:00'
                          cumulative: '20:00'
                        - split: km 5
                          split-time: '5:00'
                          cumulative: '25:00'
                        - split: km 6
                          split-time: '5:00'
                          cumulative: '30:00'
                        - split: km 7
                          split-time: '5:00'
                          cumulative: '35:00'
                        - split: km 8
                          split-time: '5:00'
                          cumulative: '40:00'
                        - split: km 9
                          split-time: '5:00'
                          cumulative: '45:00'
                        - split: km 10
                          split-time: '5:00'
                          cumulative: '50:00'
                        - split: km 11
                          split-time: '5:00'
                          cumulative: '55:00'
                        - split: km 12
                          split-time: '5:00'
                          cumulative: '1:00:00'
                        - split: km 13
                          split-time: '5:00'
                          cumulative: '1:05:00'
                        - split: km 14
                          split-time: '5:00'
                          cumulative: '1:10:00'
                        - split: km 15
                          split-time: '5:00'
                          cumulative: '1:15:00'
                        - split: km 16
                          split-time: '5:00'
                          cumulative: '1:20:00'
                        - split: km 17
                          split-time: '5:00'
                          cumulative: '1:25:00'
                        - split: km 18
                          split-time: '5:00'
                          cumulative: '1:30:00'
                        - split: km 19
                          split-time: '5:00'
                          cumulative: '1:35:00'
                        - split: km 20
                          split-time: '5:00'
                          cumulative: '1:40:00'
                        - split: km 21
                          split-time: '5:00'
                          cumulative: '1:45:00'
                        - split: 21.10 km (final)
                          split-time: '0:29'
                          cumulative: '1:45:29'
                    credits_used: 3
                    credits_remaining: null
                distance_from_5_00_km_for_30_00:
                  summary: Distance from 5:00/km for 30:00
                  value:
                    tool: running-pace-calculator
                    tool_version: 1.0.1
                    outputs:
                      summary:
                        - metric: Distance
                          value: 6.00 km
                        - metric: Total Time
                          value: '30:00'
                        - metric: Pace /km
                          value: 5:00 min/km
                        - metric: Pace /mile
                          value: 8:03 min/mi
                        - metric: Speed
                          value: 12.00 km/h
                        - metric: Speed (imperial)
                          value: 7.46 mph
                      equivalent:
                        - distance: 1 Mile
                          predicted-time: '7:26'
                          pace-km: 4:37 /km
                          pace-mile: 7:26 /mi
                        - distance: 5K
                          predicted-time: '24:44'
                          pace-km: 4:57 /km
                          pace-mile: 7:58 /mi
                        - distance: 10K
                          predicted-time: '51:33'
                          pace-km: 5:09 /km
                          pace-mile: 8:18 /mi
                        - distance: 15K
                          predicted-time: '1:19:14'
                          pace-km: 5:17 /km
                          pace-mile: 8:30 /mi
                        - distance: Half Marathon
                          predicted-time: '1:53:45'
                          pace-km: 5:24 /km
                          pace-mile: 8:41 /mi
                        - distance: Marathon
                          predicted-time: '3:57:10'
                          pace-km: 5:37 /km
                          pace-mile: 9:03 /mi
                        - distance: 50K Ultra
                          predicted-time: '4:43:55'
                          pace-km: 5:41 /km
                          pace-mile: 9:08 /mi
                        - distance: 100K Ultra
                          predicted-time: '9:51:57'
                          pace-km: 5:55 /km
                          pace-mile: 9:32 /mi
                      splits:
                        - split: km 1
                          split-time: '5:00'
                          cumulative: '5:00'
                        - split: km 2
                          split-time: '5:00'
                          cumulative: '10:00'
                        - split: km 3
                          split-time: '5:00'
                          cumulative: '15:00'
                        - split: km 4
                          split-time: '5:00'
                          cumulative: '20:00'
                        - split: km 5
                          split-time: '5:00'
                          cumulative: '25:00'
                        - split: km 6
                          split-time: '5:00'
                          cumulative: '30:00'
                    credits_used: 3
                    credits_remaining: null
                marathon_time_from_8_00_mile_pace_mile_splits:
                  summary: Marathon time from 8:00/mile pace, mile splits
                  value:
                    tool: running-pace-calculator
                    tool_version: 1.0.1
                    outputs:
                      summary:
                        - metric: Distance
                          value: 26.22 mi
                        - metric: Total Time
                          value: '3:29:45'
                        - metric: Pace /km
                          value: 4:58 min/km
                        - metric: Pace /mile
                          value: 8:00 min/mi
                        - metric: Speed
                          value: 12.07 km/h
                        - metric: Speed (imperial)
                          value: 7.50 mph
                      equivalent:
                        - distance: 1 Mile
                          predicted-time: '6:35'
                          pace-km: 4:05 /km
                          pace-mile: 6:35 /mi
                        - distance: 5K
                          predicted-time: '21:52'
                          pace-km: 4:22 /km
                          pace-mile: 7:02 /mi
                        - distance: 10K
                          predicted-time: '45:36'
                          pace-km: 4:34 /km
                          pace-mile: 7:20 /mi
                        - distance: 15K
                          predicted-time: '1:10:05'
                          pace-km: 4:40 /km
                          pace-mile: 7:31 /mi
                        - distance: Half Marathon
                          predicted-time: '1:40:36'
                          pace-km: 4:46 /km
                          pace-mile: 7:40 /mi
                        - distance: Marathon
                          predicted-time: '3:29:45'
                          pace-km: 4:58 /km
                          pace-mile: 8:00 /mi
                        - distance: 50K Ultra
                          predicted-time: '4:11:06'
                          pace-km: 5:01 /km
                          pace-mile: 8:05 /mi
                        - distance: 100K Ultra
                          predicted-time: '8:43:31'
                          pace-km: 5:14 /km
                          pace-mile: 8:26 /mi
                      splits:
                        - split: mi 1
                          split-time: '8:00'
                          cumulative: '8:00'
                        - split: mi 2
                          split-time: '8:00'
                          cumulative: '16:00'
                        - split: mi 3
                          split-time: '8:00'
                          cumulative: '24:00'
                        - split: mi 4
                          split-time: '8:00'
                          cumulative: '32:00'
                        - split: mi 5
                          split-time: '8:00'
                          cumulative: '40:00'
                        - split: mi 6
                          split-time: '8:00'
                          cumulative: '48:00'
                        - split: mi 7
                          split-time: '8:00'
                          cumulative: '56:00'
                        - split: mi 8
                          split-time: '8:00'
                          cumulative: '1:04:00'
                        - split: mi 9
                          split-time: '8:00'
                          cumulative: '1:12:00'
                        - split: mi 10
                          split-time: '8:00'
                          cumulative: '1:20:00'
                        - split: mi 11
                          split-time: '8:00'
                          cumulative: '1:28:00'
                        - split: mi 12
                          split-time: '8:00'
                          cumulative: '1:36:00'
                        - split: mi 13
                          split-time: '8:00'
                          cumulative: '1:44:00'
                        - split: mi 14
                          split-time: '8:00'
                          cumulative: '1:52:00'
                        - split: mi 15
                          split-time: '8:00'
                          cumulative: '2:00:00'
                        - split: mi 16
                          split-time: '8:00'
                          cumulative: '2:08:00'
                        - split: mi 17
                          split-time: '8:00'
                          cumulative: '2:16:00'
                        - split: mi 18
                          split-time: '8:00'
                          cumulative: '2:24:00'
                        - split: mi 19
                          split-time: '8:00'
                          cumulative: '2:32:00'
                        - split: mi 20
                          split-time: '8:00'
                          cumulative: '2:40:00'
                        - split: mi 21
                          split-time: '8:00'
                          cumulative: '2:48:00'
                        - split: mi 22
                          split-time: '8:00'
                          cumulative: '2:56:00'
                        - split: mi 23
                          split-time: '8:00'
                          cumulative: '3:04:00'
                        - split: mi 24
                          split-time: '8:00'
                          cumulative: '3:12:00'
                        - split: mi 25
                          split-time: '8:00'
                          cumulative: '3:20:00'
                        - split: mi 26
                          split-time: '8:00'
                          cumulative: '3:28:00'
                        - split: 26.22 mi (final)
                          split-time: '1:45'
                          cumulative: '3:29:45'
                    credits_used: 3
                    credits_remaining: null
              schema:
                type: object
                required:
                  - tool
                  - tool_version
                  - outputs
                  - credits_used
                  - credits_remaining
                properties:
                  outputs:
                    type: object
                    properties:
                      summary:
                        type: array
                        description: Result
                        items:
                          type: object
                          properties:
                            metric:
                              type: string
                              description: Metric
                            value:
                              type: string
                              description: Value
                        x-iotools-columns:
                          - metric
                          - value
                      equivalent:
                        type: array
                        description: Equivalent Race Times (Riegel formula)
                        items:
                          type: object
                          properties:
                            distance:
                              type: string
                              description: Distance
                            predicted-time:
                              type: string
                              description: Predicted Time
                            pace-km:
                              type: string
                              description: Pace /km
                            pace-mile:
                              type: string
                              description: Pace /mile
                        x-iotools-columns:
                          - distance
                          - predicted-time
                          - pace-km
                          - pace-mile
                      splits:
                        type: array
                        description: Even Splits
                        items:
                          type: object
                          properties:
                            split:
                              type: string
                              description: Split
                            split-time:
                              type: string
                              description: Split Time
                            cumulative:
                              type: string
                              description: Cumulative
                        x-iotools-columns:
                          - split
                          - split-time
                          - cumulative
                  tool:
                    type: string
                    description: The tool's slug, echoing the {slug} in the request path.
                  tool_version:
                    type: string
                    description: Output-contract version for this tool.
                  credits_used:
                    type: integer
                    description: >-
                      Credits this call consumed, after any settlement refund. 0
                      when metering is disabled.
                  credits_remaining:
                    type:
                      - integer
                      - 'null'
                    description: >-
                      Credits left in the current monthly allowance, or null
                      when metering is disabled.
                  request_id:
                    type: string
                    description: Correlation id, also sent as x-request-id.
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/InsufficientCredits'
        '403':
          $ref: '#/components/responses/ToolNotAllowed'
        '404':
          $ref: '#/components/responses/ToolNotFound'
        '413':
          $ref: '#/components/responses/PayloadTooLarge'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ToolFailed'
        '503':
          $ref: '#/components/responses/ToolDisabled'
      security:
        - bearerAuth: []
components:
  responses:
    ValidationError:
      description: Invalid request.
      content:
        application/problem+json:
          schema:
            type: object
            description: >-
              RFC 9457 problem document, served as application/problem+json.
              Branch on `code`; `title` is human prose and may be reworded
              without notice. Some failures add extension members — `fields` on
              validation errors, `retry_after` on 429s,
              `credits_used`/`credits_remaining` on billing-adjacent failures —
              documented on the responses that carry them.
            required:
              - type
              - title
              - status
              - code
            properties:
              type:
                type: string
                format: uri
                description: Stable documentation URI for this failure.
                examples:
                  - https://iotools.cloud/docs/errors/validation_error
              title:
                type: string
                description: Short human-readable summary of the failure.
                examples:
                  - Invalid request
              status:
                type: integer
                description: HTTP status code, matching the response's own status.
              code:
                type: string
                description: >-
                  Stable machine-readable error code — branch on this, not
                  `title`.
                enum:
                  - validation_error
              detail:
                type: string
                description: Human explanation of this occurrence.
              request_id:
                type: string
                description: Correlation id, also sent as x-request-id.
              fields:
                type:
                  - object
                  - string
                additionalProperties:
                  type: string
                description: >-
                  What failed: a map of field name → message. Absent when the
                  body itself is malformed; a single string when the failure
                  isn't tied to one field.
          example:
            type: https://iotools.cloud/docs/errors/validation_error
            title: Invalid request
            status: 400
            code: validation_error
            detail: One or more inputs are invalid — see `fields`.
            request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11
            fields:
              inputString: Required
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/problem+json:
          schema:
            type: object
            description: >-
              RFC 9457 problem document, served as application/problem+json.
              Branch on `code`; `title` is human prose and may be reworded
              without notice. Some failures add extension members — `fields` on
              validation errors, `retry_after` on 429s,
              `credits_used`/`credits_remaining` on billing-adjacent failures —
              documented on the responses that carry them.
            required:
              - type
              - title
              - status
              - code
            properties:
              type:
                type: string
                format: uri
                description: Stable documentation URI for this failure.
                examples:
                  - https://iotools.cloud/docs/errors/invalid_api_key
              title:
                type: string
                description: Short human-readable summary of the failure.
                examples:
                  - Invalid API key
              status:
                type: integer
                description: HTTP status code, matching the response's own status.
              code:
                type: string
                description: >-
                  Stable machine-readable error code — branch on this, not
                  `title`.
                enum:
                  - invalid_api_key
              detail:
                type: string
                description: Human explanation of this occurrence.
              request_id:
                type: string
                description: Correlation id, also sent as x-request-id.
          example:
            type: https://iotools.cloud/docs/errors/invalid_api_key
            title: Invalid API key
            status: 401
            code: invalid_api_key
            detail: 'Provide ''Authorization: Bearer <key>''.'
            request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11
    InsufficientCredits:
      description: Monthly credit allowance exhausted.
      content:
        application/problem+json:
          schema:
            type: object
            description: >-
              RFC 9457 problem document, served as application/problem+json.
              Branch on `code`; `title` is human prose and may be reworded
              without notice. Some failures add extension members — `fields` on
              validation errors, `retry_after` on 429s,
              `credits_used`/`credits_remaining` on billing-adjacent failures —
              documented on the responses that carry them.
            required:
              - type
              - title
              - status
              - code
            properties:
              type:
                type: string
                format: uri
                description: Stable documentation URI for this failure.
                examples:
                  - https://iotools.cloud/docs/errors/insufficient_credits
              title:
                type: string
                description: Short human-readable summary of the failure.
                examples:
                  - Insufficient credits
              status:
                type: integer
                description: HTTP status code, matching the response's own status.
              code:
                type: string
                description: >-
                  Stable machine-readable error code — branch on this, not
                  `title`.
                enum:
                  - insufficient_credits
              detail:
                type: string
                description: Human explanation of this occurrence.
              request_id:
                type: string
                description: Correlation id, also sent as x-request-id.
              credits_used:
                type: integer
                description: Always 0 — a refused call charges nothing.
              credits_remaining:
                type: integer
                description: Credits left in the allowance — fewer than this call costs.
          example:
            type: https://iotools.cloud/docs/errors/insufficient_credits
            title: Insufficient credits
            status: 402
            code: insufficient_credits
            detail: This call costs 1 credit and 0 remain in this month's allowance.
            request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11
            credits_used: 0
            credits_remaining: 0
    ToolNotAllowed:
      description: Tool exists but has no API surface.
      content:
        application/problem+json:
          schema:
            type: object
            description: >-
              RFC 9457 problem document, served as application/problem+json.
              Branch on `code`; `title` is human prose and may be reworded
              without notice. Some failures add extension members — `fields` on
              validation errors, `retry_after` on 429s,
              `credits_used`/`credits_remaining` on billing-adjacent failures —
              documented on the responses that carry them.
            required:
              - type
              - title
              - status
              - code
            properties:
              type:
                type: string
                format: uri
                description: Stable documentation URI for this failure.
                examples:
                  - https://iotools.cloud/docs/errors/tool_not_allowed
              title:
                type: string
                description: Short human-readable summary of the failure.
                examples:
                  - Tool not available over the API
              status:
                type: integer
                description: HTTP status code, matching the response's own status.
              code:
                type: string
                description: >-
                  Stable machine-readable error code — branch on this, not
                  `title`.
                enum:
                  - tool_not_allowed
              detail:
                type: string
                description: Human explanation of this occurrence.
              request_id:
                type: string
                description: Correlation id, also sent as x-request-id.
          example:
            type: https://iotools.cloud/docs/errors/tool_not_allowed
            title: Tool not available over the API
            status: 403
            code: tool_not_allowed
            detail: >-
              "Background Remover" is available on iotools.cloud but has no API
              endpoint.
            request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11
    ToolNotFound:
      description: No such tool.
      content:
        application/problem+json:
          schema:
            type: object
            description: >-
              RFC 9457 problem document, served as application/problem+json.
              Branch on `code`; `title` is human prose and may be reworded
              without notice. Some failures add extension members — `fields` on
              validation errors, `retry_after` on 429s,
              `credits_used`/`credits_remaining` on billing-adjacent failures —
              documented on the responses that carry them.
            required:
              - type
              - title
              - status
              - code
            properties:
              type:
                type: string
                format: uri
                description: Stable documentation URI for this failure.
                examples:
                  - https://iotools.cloud/docs/errors/tool_not_found
              title:
                type: string
                description: Short human-readable summary of the failure.
                examples:
                  - Tool not found
              status:
                type: integer
                description: HTTP status code, matching the response's own status.
              code:
                type: string
                description: >-
                  Stable machine-readable error code — branch on this, not
                  `title`.
                enum:
                  - tool_not_found
              detail:
                type: string
                description: Human explanation of this occurrence.
              request_id:
                type: string
                description: Correlation id, also sent as x-request-id.
          example:
            type: https://iotools.cloud/docs/errors/tool_not_found
            title: Tool not found
            status: 404
            code: tool_not_found
            detail: No tool with that slug. See GET /v1/tools/list.
            request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11
    PayloadTooLarge:
      description: Body too large.
      content:
        application/problem+json:
          schema:
            type: object
            description: >-
              RFC 9457 problem document, served as application/problem+json.
              Branch on `code`; `title` is human prose and may be reworded
              without notice. Some failures add extension members — `fields` on
              validation errors, `retry_after` on 429s,
              `credits_used`/`credits_remaining` on billing-adjacent failures —
              documented on the responses that carry them.
            required:
              - type
              - title
              - status
              - code
            properties:
              type:
                type: string
                format: uri
                description: Stable documentation URI for this failure.
                examples:
                  - https://iotools.cloud/docs/errors/payload_too_large
              title:
                type: string
                description: Short human-readable summary of the failure.
                examples:
                  - Payload too large
              status:
                type: integer
                description: HTTP status code, matching the response's own status.
              code:
                type: string
                description: >-
                  Stable machine-readable error code — branch on this, not
                  `title`.
                enum:
                  - payload_too_large
              detail:
                type: string
                description: Human explanation of this occurrence.
              request_id:
                type: string
                description: Correlation id, also sent as x-request-id.
          example:
            type: https://iotools.cloud/docs/errors/payload_too_large
            title: Payload too large
            status: 413
            code: payload_too_large
            detail: Request body exceeds this tool's size limit.
            request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11
    RateLimited:
      description: Per-minute rate limit exceeded.
      headers:
        Retry-After:
          description: Seconds to wait before retrying (RFC 9110 delta-seconds).
          schema:
            type: integer
      content:
        application/problem+json:
          schema:
            type: object
            description: >-
              RFC 9457 problem document, served as application/problem+json.
              Branch on `code`; `title` is human prose and may be reworded
              without notice. Some failures add extension members — `fields` on
              validation errors, `retry_after` on 429s,
              `credits_used`/`credits_remaining` on billing-adjacent failures —
              documented on the responses that carry them.
            required:
              - type
              - title
              - status
              - code
            properties:
              type:
                type: string
                format: uri
                description: Stable documentation URI for this failure.
                examples:
                  - https://iotools.cloud/docs/errors/rate_limited
              title:
                type: string
                description: Short human-readable summary of the failure.
                examples:
                  - Rate limit exceeded
              status:
                type: integer
                description: HTTP status code, matching the response's own status.
              code:
                type: string
                description: >-
                  Stable machine-readable error code — branch on this, not
                  `title`.
                enum:
                  - rate_limited
              detail:
                type: string
                description: Human explanation of this occurrence.
              request_id:
                type: string
                description: Correlation id, also sent as x-request-id.
              retry_after:
                type: integer
                description: >-
                  Seconds until the window resets — the same value as the
                  `Retry-After` header.
          example:
            type: https://iotools.cloud/docs/errors/rate_limited
            title: Rate limit exceeded
            status: 429
            code: rate_limited
            detail: Too many requests. Retry in 30s.
            request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11
            retry_after: 30
    ToolFailed:
      description: Tool failed to run.
      content:
        application/problem+json:
          schema:
            type: object
            description: >-
              RFC 9457 problem document, served as application/problem+json.
              Branch on `code`; `title` is human prose and may be reworded
              without notice. Some failures add extension members — `fields` on
              validation errors, `retry_after` on 429s,
              `credits_used`/`credits_remaining` on billing-adjacent failures —
              documented on the responses that carry them.
            required:
              - type
              - title
              - status
              - code
            properties:
              type:
                type: string
                format: uri
                description: Stable documentation URI for this failure.
                examples:
                  - https://iotools.cloud/docs/errors/processing_error
                  - https://iotools.cloud/docs/errors/internal_error
              title:
                type: string
                description: Short human-readable summary of the failure.
                examples:
                  - Tool failed to run
                  - Internal error
              status:
                type: integer
                description: HTTP status code, matching the response's own status.
              code:
                type: string
                description: >-
                  Stable machine-readable error code — branch on this, not
                  `title`.
                enum:
                  - processing_error
                  - internal_error
              detail:
                type: string
                description: Human explanation of this occurrence.
              request_id:
                type: string
                description: Correlation id, also sent as x-request-id.
              credits_used:
                type: integer
                description: >-
                  Always 0 on `processing_error` — a failed run is refunded,
                  floor included.
              credits_remaining:
                type: integer
                description: >-
                  Credits left after the refund. Absent when metering is
                  disabled.
          example:
            type: https://iotools.cloud/docs/errors/processing_error
            title: Tool failed to run
            status: 500
            code: processing_error
            detail: The tool failed to run. Please try again.
            request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11
            credits_used: 0
    ToolDisabled:
      description: Tool temporarily disabled.
      content:
        application/problem+json:
          schema:
            type: object
            description: >-
              RFC 9457 problem document, served as application/problem+json.
              Branch on `code`; `title` is human prose and may be reworded
              without notice. Some failures add extension members — `fields` on
              validation errors, `retry_after` on 429s,
              `credits_used`/`credits_remaining` on billing-adjacent failures —
              documented on the responses that carry them.
            required:
              - type
              - title
              - status
              - code
            properties:
              type:
                type: string
                format: uri
                description: Stable documentation URI for this failure.
                examples:
                  - https://iotools.cloud/docs/errors/tool_disabled
                  - https://iotools.cloud/docs/errors/api_unconfigured
              title:
                type: string
                description: Short human-readable summary of the failure.
                examples:
                  - Tool temporarily disabled
                  - API not configured
              status:
                type: integer
                description: HTTP status code, matching the response's own status.
              code:
                type: string
                description: >-
                  Stable machine-readable error code — branch on this, not
                  `title`.
                enum:
                  - tool_disabled
                  - api_unconfigured
              detail:
                type: string
                description: Human explanation of this occurrence.
              request_id:
                type: string
                description: Correlation id, also sent as x-request-id.
          example:
            type: https://iotools.cloud/docs/errors/tool_disabled
            title: Tool temporarily disabled
            status: 503
            code: tool_disabled
            detail: This tool is temporarily unavailable. Try again shortly.
            request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: iot_live_…

````