Fetch Call Recording

Once an AI-powered call finishes, Scalysis stores the call audio and makes every recording for that order available through the recordings endpoint. Use it to download the original file, attach it in your CRM, or play it back for a QA review.

When to fetch

The recording exists only after the call has ended and the audio has been saved. If you fetch too early, the order can be found with an empty recordings list. Wait until the call has had time to complete, typically 30 seconds to a few minutes, then fetch again.

A Shopify order id is optional. Send whichever one id you already have: the Scalysis orderId, the Shopify shopifyOrderId, or the orderNumber such as #34127.

Pick one order reference

You do not need all three. Pass whichever id you already have.

number

The Scalysis id returned when you triggered the call, for example 1952789. This is not the Shopify id.

string

Shopify’s numeric order id, for example 9911279517782. The gid://shopify/Order/... form also works.

string

The order name you see in Shopify, for example #34127. In the URL, write # as %23.

List the recordings

Swap in your real API key and one order reference.

curl -sS 'https://app.scalysis.com/api/v1/orders/recordings?shopifyOrderId=9911279517782' \
  -H 'Authorization: Bearer YOUR_API_KEY'

The same call with the other two lookups:

curl -sS 'https://app.scalysis.com/api/v1/orders/recordings?orderId=1952789' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl -sS 'https://app.scalysis.com/api/v1/orders/recordings?orderNumber=%2334127' \
  -H 'Authorization: Bearer YOUR_API_KEY'

No request body is needed.

Read the response

A completed order with one call returns:

{
  "success": true,
  "matchedBy": "shopifyOrderId",
  "orders": [
    {
      "orderId": 1952789,
      "shopifyOrderId": "9911279517782",
      "orderNumber": "#34127",
      "recordings": [
        {
          "callId": 440905,
          "calledAt": "2026-10-07T03:52:51.320Z",
          "recordingUrl": "https://app.scalysis.com/api/v1/orders/1952789/recording?callId=440905&t=SIGNED_TOKEN"
        }
      ]
    }
  ]
}

boolean

true when the order was found.

string

Which lookup matched: orderId, shopifyOrderId, or orderNumber.

array

Matching orders for this shop. Usually one.

number

Scalysis order id. Use this in the download URL.

string

Shopify’s numeric order id, when the order came from Shopify. null for a manual order.

string

Order name, such as #34127.

array

Every saved recording, oldest first. Empty if the audio is not saved yet.

number

One call. An order can have more than one.

string

When that call started, in UTC.

string

Link that downloads that call’s original audio.

recordingUrl already includes callId and a signed t token. Opening it does not need a second login. The token works only for that shop, that order, and that call.

Download one recording

Use recordingUrl from the list as-is:

curl -sS 'https://app.scalysis.com/api/v1/orders/1952789/recording?callId=440905&t=SIGNED_TOKEN' \
  --output call.audio

You can also call the same path with your API key and skip the token:

curl -sS 'https://app.scalysis.com/api/v1/orders/1952789/recording?callId=440905' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  --output call.audio

The response is the original audio file, not JSON. Content-Type is the stored type, such as audio/mpeg or audio/wav. The file is not re-encoded.If the order has several recordings, pass the callId of the one you want. Without callId, the endpoint returns the latest completed call’s audio.

Handle missing audio

The order exists, but no file is saved yet:

{
  "success": true,
  "matchedBy": "orderNumber",
  "orders": [
    {
      "orderId": 1952789,
      "shopifyOrderId": "9911279517782",
      "orderNumber": "#34127",
      "recordings": []
    }
  ]
}

Wait 10–30 seconds and request the list again.

error

Missing or invalid API key.

error

You did not send orderId, shopifyOrderId, or orderNumber.

error

No order for this shop, or that callId has no recording.

error

The audio file could not be loaded.

Get Started

Core Concepts

Guides

Help

Fetch Call Recording

When to fetch

​When to fetch

When to fetch