Get an assistant · BluePenguin Docs

#Parameters

assistant_idinteger · pathrequired

#Example request

curl https://app.bluepenguin.io/api/v1/assistants/12 \
  -H "Authorization: Bearer $BLUEPENGUIN_KEY"

const r = await fetch('https://app.bluepenguin.io/api/v1/assistants/12', {
  method: 'GET',
  headers: {
    authorization: `Bearer ${process.env.BLUEPENGUIN_KEY}`,
  },
})
const data = await r.json()

import os, requests

r = requests.get(
    "https://app.bluepenguin.io/api/v1/assistants/12",
    headers={"Authorization": f"Bearer {os.environ['BLUEPENGUIN_KEY']}"},
)
data = r.json()

#Example response

200 OK

{
  "id": 12,
  "name": "Front desk",
  "is_default": true,
  "created_at": "2026-09-30T10:12:00Z",
  "updated_at": "2026-10-02T08:40:11Z",
  "config": {
    "first_message_mode": "assistant_first",
    "first_message": "Thanks for calling Brightside Dental, this is Ava.",
    "system_prompt": "You are Ava…",
    "language": "en",
    "mode": "standard",
    "voice": {
      "voice_id": "cartesia:…",
      "speed": 1
    },
    "builtin": {
      "booking": true,
      "messages": true,
      "transfer": true,
      "sms": true,
      "payment_links": true,
      "knowledge": true,
      "end_call": true
    },
    "…": "…"
  }
}

#Errors

Status	When
`401`	Missing or invalid API key.
`404`	`not_found`: it doesn't exist or belongs to another business.
`422`	A parameter or field is invalid; the reply lists which.
`429`	More than 240 requests a minute on this key.