Calls and history

Call recordings

Call recordings are the audio of recorded calls, looked up by call ID.

In the Key Admin this is the Call recordings switch. Read lets a key call the GET endpoints below. This feature is read only.

This feature holds sensitive data about callers and calls. Keep what you pull secure and only keep it as long as you need it.

Get recordings for a call

GET/domains/~/recordings/{callid}

Returns the recording details and audio links for one call.

Read Key Admin switch: Call recordings, Read. Read only keys also work. Sensitive data

Parameters

Name	In	Type	Notes
`callid` required	path	string	The call ID from a live call or call record.

Example request

curl -X GET "https://api.noodlevoice.com/ns-api/v2/domains/~/recordings/{call_id}" \
  -H "Authorization: Bearer $NOODLEVOICE_KEY"

const res = await fetch("https://api.noodlevoice.com/ns-api/v2/domains/~/recordings/{call_id}", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.NOODLEVOICE_KEY,
  },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://api.noodlevoice.com/ns-api/v2/domains/~/recordings/{call_id}",
    headers={"Authorization": "Bearer " + os.environ["NOODLEVOICE_KEY"]},
)
print(r.status_code, r.json())

Response 200

[
  {
    "call-recording-status": "string",
    "call-id": "string",
    "call-recording-started-datetime": "2026-11-02 09:00:00",
    "call-recording-ended-datetime": "2026-11-02 09:00:00",
    "call-recording-remote-wav": "string",
    "call-recording-remote-wav-size-kilobytes": 1,
    "call-recording-remote-storage-config-id": "string",
    "call-recording-match-pattern": "string",
    "...": "5 more fields"
  }
]

Response fields (13)

Field	Type	Notes
`call-recording-status`	string
`call-id`	string	The call ID.
`call-recording-started-datetime`	string	Call recording started (date and time).
`call-recording-ended-datetime`	string	Call recording ended (date and time).
`call-recording-remote-wav`	string
`call-recording-remote-wav-size-kilobytes`	integer
`call-recording-remote-storage-config-id`	string	ID of the call recording remote storage config.
`call-recording-match-pattern`	string
`call-recording-retrieved-datetime`	string	Call recording retrieved (date and time).
`file-duration-seconds`	integer	File duration, in seconds.
`file-access-url`	string
`geo-call-id`	string	ID of the geo call.
`file-size-kilobytes`	integer

Get a user's recordings for a call

GET/domains/~/users/{user}/recordings/{callid}

Returns recordings for one call, looked up through the user who was on it.

Full access No feature switch covers this endpoint. It needs a Full access key.

Parameters

Name	In	Type	Notes
`user` required	path	string	The user ID, usually their extension number, like `1001`. Default `~` Min length 0 Max length 16
`callid` required	path	string	The call ID from a live call or call record.

Example request

curl -X GET "https://api.noodlevoice.com/ns-api/v2/domains/~/users/1001/recordings/{call_id}" \
  -H "Authorization: Bearer $NOODLEVOICE_KEY"

const res = await fetch("https://api.noodlevoice.com/ns-api/v2/domains/~/users/1001/recordings/{call_id}", {
  method: "GET",
  headers: {
    Authorization: "Bearer " + process.env.NOODLEVOICE_KEY,
  },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://api.noodlevoice.com/ns-api/v2/domains/~/users/1001/recordings/{call_id}",
    headers={"Authorization": "Bearer " + os.environ["NOODLEVOICE_KEY"]},
)
print(r.status_code, r.json())

Response 200

[
  {
    "call-recording-status": "string",
    "call-id": "string",
    "call-recording-started-datetime": "2026-11-02 09:00:00",
    "call-recording-ended-datetime": "2026-11-02 09:00:00",
    "call-recording-remote-wav": "string",
    "call-recording-remote-wav-size-kilobytes": 1,
    "call-recording-remote-storage-config-id": "string",
    "call-recording-match-pattern": "string",
    "...": "5 more fields"
  }
]

Response fields (13)

Field	Type	Notes
`call-recording-status`	string
`call-id`	string	The call ID.
`call-recording-started-datetime`	string	Call recording started (date and time).
`call-recording-ended-datetime`	string	Call recording ended (date and time).
`call-recording-remote-wav`	string
`call-recording-remote-wav-size-kilobytes`	integer
`call-recording-remote-storage-config-id`	string	ID of the call recording remote storage config.
`call-recording-match-pattern`	string
`call-recording-retrieved-datetime`	string	Call recording retrieved (date and time).
`file-duration-seconds`	integer	File duration, in seconds.
`file-access-url`	string
`geo-call-id`	string	ID of the geo call.
`file-size-kilobytes`	integer