Skip to main content
GET
/
plaud
/
files
List recordings
curl --request GET \
  --url https://{deployment}/api/v1/plaud/files \
  --header 'X-API-KEY: <api-key>'
{
  "status": 123,
  "data_file_total": 123,
  "data_file_list": [
    {
      "id": "<string>",
      "filename": "<string>",
      "keywords": [
        "<string>"
      ],
      "filesize": 123,
      "filetype": "<string>",
      "is_trash": true,
      "start_time": 123,
      "end_time": 123,
      "duration": 123,
      "filetag_id_list": [
        "<string>"
      ],
      "is_trans": true,
      "is_summary": true,
      "start_time_human": "<string>",
      "duration_human": "<string>"
    }
  ]
}

Authorizations

X-API-KEY
string
header
required

Your deployment's API key (MMK_API_KEY). Your Plaud account credentials are stored server-side — you do not send them.

Query Parameters

limit
integer
default:20

Max files to return.

skip
integer
default:0

Offset for pagination.

is_trash
enum<integer>
default:0

0 = active, 1 = trash, 2 = both.

Available options:
0,
1,
2
sort_by
enum<string>
default:edit_time

Sort field.

Available options:
edit_time,
start_time
is_desc
boolean
default:true

Descending order.

Response

File listing

status
integer
data_file_total
integer
data_file_list
object[]