HAhappyscribe
Orders

Confirm an order

Confirms an order previously created with confirm: false. Once confirmed, the order begins processing according to the selected service type.

post/orders/{id}/confirm

Request

  • Base URL
    https://www.happyscribe.com/api/v1
  • Auth
    API key in header Authorization

Path parameters

idstring required
Example:10b1edd9381d4a00a3d0db1ca1b3d0cf

ID of the order (UUID format).

Response

Order was confirmed and submitted for processing.

idstring

Unique identifier for the order (UUID format).

folder_idinteger
state'incomplete' | 'waiting_for_payment' | 'submitted' | 'locked' | 'fulfilled' | 'failed' | 'canceled' | 'expired' | 'free_trial_submitted' | 'free_trial_fulfilled'

Current state of the order:

  • incomplete — created but not yet submitted
  • waiting_for_payment — waiting for payment to be processed
  • submitted — submitted, processing in progress
  • locked — insufficient credits or balance; unlock from the UI after topping up
  • fulfilled — completed successfully
  • failed — processing failed; see failure_reason
  • canceled — the order was canceled
  • expired — an old failed or incomplete order that has been cleaned up
  • free_trial_submitted / free_trial_fulfilled — legacy free-trial states
can_be_submittedboolean
outputs_idsstring[]

IDs (UUIDs) of the generated transcriptions or translations. Only present when the order is fulfilled.

failure_reason'ingestion_failed' | 'transcription_failed' | 'unknown'

Present when state is failed:

  • ingestion_failed — one or more files could not be imported; inspect ingestions[]
  • transcription_failed — the transcription/subtitling step failed; inspect transcriptions[]
  • unknown — no identifiable cause; contact support

Example response

{
  "id": "10b1edd9381d4a00a3d0db1ca1b3d0cf",
  "folder_id": 1,
  "state": "incomplete",
  "operations": [
    {
      "name": "transcription_translation",
      "type": "auto",
      "language": "en-US",
      "target_language": "es",
      "glossary_ids": []
    }
  ],
  "details": {
    "items": [
      {
        "input_id": 258,
        "filename": "TED+Talk",
        "pricing_unit_name": "minutes",
        "pricing_unit_count": 0.12,
        "turnaround_minutes": 1,
        "cents_per_unit": 20,
        "cents": 3,
        "credits": 0.12
      }
    ],
    "pricing_unit_name": "minutes",
    "pricing_unit_total_count": 0.12,
    "total_cents": 3,
    "total_credits": 0.12,
    "currency": "usd",
    "currency_symbol": "$",
    "minimum_charge": 50
  },
  "addons": [],
  "inputs": [
    {
      "transcription_id": "e5fb537cecc9436b93c04be2a9219001"
    }
  ],
  "can_be_submitted": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.