Voices

List voices

Returns every voice profile in this workspace for the key's mode (test or live).

GET

curl https://api.intactvoice.com/v1/voices \
  -H "Authorization: Bearer $API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "voice_8f2k1x",
      "object": "voice",
      "name": "Founder voice",
      "created": 1791100000,
      "status": "ready",
      "samples": 2,
      "words": 1840,
      "platforms": [
        "blog",
        "x"
      ],
      "traits": {
        "sentence_length_mean": 10.5,
        "sentence_length_sd": 6.5,
        "sentence_length_hist": [
          {
            "bucket": "1-5",
            "share": 0.3
          },
          {
            "bucket": "6-10",
            "share": 0.3
          },
          {
            "bucket": "11-15",
            "share": 0.1
          },
          {
            "bucket": "16-20",
            "share": 0.1
          },
          {
            "bucket": "21-30",
            "share": 0.2
          },
          {
            "bucket": "31+",
            "share": 0
          }
        ],
        "paragraph_sentences_mean": 5,
        "punctuation_per_100_words": {
          "period": 8.6,
          "comma": 2.9,
          "colon": 0,
          "question": 1,
          "exclamation": 0,
          "parenthesis": 0,
          "em_dash": 0,
          "semicolon": 0,
          "ellipsis": 0
        },
        "uses_em_dash": false,
        "numbered_steps": false,
        "contractions_per_100_words": 3.8,
        "first_person_per_100_words": 4.8,
        "reading_grade": 4.6,
        "opens_with": "a first-person statement",
        "endings": "status_update",
        "reveals_with": "plain statements",
        "distinctive_words": [
          "notebook",
          "beds",
          "soil",
          "frost",
          "morning",
          "neighbor"
        ]
      },
      "baseline": {
        "ai_likelihood_mean": 0.19,
        "detectors": {
          "meld": 0.12,
          "vanguard": 0.21,
          "desklib": 0.24
        }
      },
      "style_card": {
        "summary": "Short first-person sentences about what happened, plain words, ends on where things stand now.",
        "exemplars": [
          "I waited two more weeks and lost none."
        ]
      }
    }
  ]
}

200 OK

Response

200 · application/json

object"list"

Always "list".

dataVoice[]

The voice profiles, newest first. Each has the fields shown on Retrieve a voice.

Errors

401invalid_api_key
429rate_limited