List user MoH files

GET

/domains/{domain}/users/{user}/moh

Last modified:2026-10-09 00:31:43

OperationId:ReadMohUser

Lists the music on hold (MoH) files of the user, in index order.

Any user can read their own MoH. Site Manager and Office Manager can read any user's MoH in their domain, a Reseller any user in its territory, and Super User any user.

Returns up to 100 files by default; page with limit and start. Count them with GET /domains/{domain}/users/{user}/moh/count. file-access-url is a signed link that plays the file with no token, for 24 hours by default; see GET /domains/{domain}/users/{user}/moh/{index}/play.

A user that does not exist returns 400 with Invalid User.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200OK

application/json

The MoH files, in index order. An owner with no MoH answers an empty array.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠404Record not found

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//moh?limit=undefined&start=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - MoH files

An uploaded track and a text-to-speech message.

[
    {
        "filename": "moh-01.wav",
        "ordinal-order": 1,
        "file-duration-seconds": 45,
        "file-size-kilobytes": "351.61 KB",
        "created-datetime": "2026-09-01T14:30:00+00:00",
        "file-script-text": "Hold music, instrumental",
        "file-source": "",
        "text-to-speech-voice-id": "",
        "text-to-speech-language": ""
    },
    {
        "filename": "moh-02.wav",
        "ordinal-order": 2,
        "file-duration-seconds": 8,
        "file-size-kilobytes": "62.55 KB",
        "created-datetime": "2026-09-01T14:30:00+00:00",
        "file-script-text": "Thank you for holding. Your call is important to us.",
        "file-source": "",
        "text-to-speech-voice-id": "en-US-Wavenet-C",
        "text-to-speech-language": "en-US"
    }
]

Modified at 2026-10-09 00:31:43

Play domain MoH file

Count user MoH files