Skip to main content
GET
/
api
/
v1
/
playnotes
/
{playNoteId}
cURL
curl --request GET \
  --url https://api.play.ai/api/v1/playnotes/{playNoteId} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-USER-ID: <api-key>'
{
  "id": "qHMJf1MqlSPsfBdQIyYi",
  "ownerId": "gpTwobxZzJRczfqommFemErGJTU2",
  "name": "<string>",
  "sourceFileUrl": "<string>",
  "audioUrl": "<string>",
  "synthesisStyle": "podcast",
  "voice1": "s3://voice-cloning-zero-shot/baf1ef41-36b6-428c-9bdf-50ba54682bd8/original/manifest.json",
  "voice1Name": "<string>",
  "voice1Gender": "Male",
  "voice2": "s3://voice-cloning-zero-shot/baf1ef41-36b6-428c-9bdf-50ba54682bd8/original/manifest.json",
  "voice2Name": "<string>",
  "voice2Gender": "Male",
  "webHookUrl": "https://my.webhook.url.com",
  "status": "generating",
  "duration": 123,
  "requestedAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Your secret API key from PlayAI, formatted as Bearer YOUR_SECRET_API_KEY.

​
X-USER-ID
string
header
required

Your unique user ID from PlayAI.

Headers

​
accept
enum<string>
Available options:
application/json

Path Parameters

​
playNoteId
string
required

The PlayNote's ID

Example:

"qHMJf1MqlSPsfBdQIyYi"

Response

200 - application/json

PlayNote retrieved successfully

​
id
string
required

The unique ID for each PlayNote

Example:

"qHMJf1MqlSPsfBdQIyYi"

​
ownerId
string
required

The PlayAI unique ID for each user

Example:

"gpTwobxZzJRczfqommFemErGJTU2"

​
name
string
required

The name of the PlayNote

​
sourceFileUrl
string<uri>
required

URL to the source file

​
synthesisStyle
enum<string>
required

The synthesis style of the PlayNote

Available options:
podcast,
executive-briefing,
childrens-story,
debate
​
voice1
string
required

The unique ID for the first voice to be used.

💡 Tip: Check out the How to Get ID of Voices guide

Example:

"s3://voice-cloning-zero-shot/baf1ef41-36b6-428c-9bdf-50ba54682bd8/original/manifest.json"

​
status
enum<string>
required

The current status of the PlayNote

Available options:
generating,
completed,
failed
​
requestedAt
string<date-time>
required

When the PlayNote was requested

​
audioUrl
string<uri> | null

URL to the generated PlayNote audio file

​
voice1Name
string

Name of the voice1 character

​
voice1Gender
enum<string>

Gender of the voice1 character

Available options:
Male,
Female
​
voice2
string

The unique ID for the second voice to be used.

💡 Tip: Check out the How to Get ID of Voices guide

Example:

"s3://voice-cloning-zero-shot/baf1ef41-36b6-428c-9bdf-50ba54682bd8/original/manifest.json"

​
voice2Name
string | null

Name of the voice2 character

​
voice2Gender
enum<string> | null

Gender of the voice2 character

Available options:
Male,
Female
​
webHookUrl
string<uri>

A URL to receive status updates for the PlayNote

Example:

"https://my.webhook.url.com"

​
duration
number | null

Duration of the audio in seconds

​
createdAt
string<date-time> | null

When the PlayNote was created