# Get Guest Profile Details

> Pod Engine API endpoint reference, optimized for LLM consumption.
> Auto-generated from the source-of-truth endpoint registry.
>
> Category: Guest Profiles
> Source: https://www.podengine.ai/api-docs/get-guest-profile-details.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/get-guest-profile-details
> Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt

**Base URL:** `http://localhost:4000`
**Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY`

---

#### GET /api/v1/guest-profiles/:guestProfileIdOrProjectId
**Get Guest Profile Details**

Get detailed information about a specific guest profile including bio, contact details, social media links, and documents

```bash
curl -X GET "http://localhost:4000/api/v1/guest-profiles/example-guest-profile-id" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Path parameters schema:**
```json
{
  "type": "object",
  "properties": {
    "guestProfileIdOrProjectId": {
      "type": "string",
      "description": "The id of the project associated with the guest profile or the guest profile id."
    }
  },
  "required": [
    "guestProfileIdOrProjectId"
  ],
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "projectId": {
          "type": "string"
        },
        "projectSlug": {
          "type": "string"
        },
        "guestProfileId": {
          "type": "string"
        },
        "guestProfileSlug": {
          "type": "string"
        },
        "publicSlug": {
          "nullable": true,
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "ACTIVE",
            "DRAFT",
            "PENDING",
            "ARCHIVED",
            "ERROR"
          ]
        },
        "createdAt": {},
        "updatedAt": {},
        "documents": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "id": {
                "type": "string"
              },
              "size": {
                "type": "number"
              },
              "status": {
                "type": "string"
              },
              "fileType": {
                "type": "string"
              },
              "dateExtracted": {
                "nullable": true
              }
            },
            "required": [
              "name",
              "id",
              "size",
              "status",
              "fileType",
              "dateExtracted"
            ],
            "additionalProperties": false
          }
        },
        "listedPodcastsCount": {
          "type": "number"
        },
        "bookingUrl": {
          "nullable": true,
          "type": "string"
        },
        "companyName": {
          "nullable": true,
          "type": "string"
        },
        "email": {
          "nullable": true,
          "type": "string"
        },
        "firstName": {
          "nullable": true,
          "type": "string"
        },
        "lastName": {
          "nullable": true,
          "type": "string"
        },
        "onePagerUrl": {
          "nullable": true,
          "type": "string"
        },
        "phone": {
          "nullable": true,
          "type": "string"
        },
        "websiteUrl": {
          "nullable": true,
          "type": "string"
        },
        "imageUrl": {
          "nullable": true,
          "type": "string"
        },
        "createdBy": {
          "type": "object",
          "properties": {
            "userId": {
              "type": "string"
            },
            "email": {
              "type": "string"
            }
          },
          "required": [
            "userId",
            "email"
          ],
          "additionalProperties": false
        },
        "socialMediaLinks": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "socialMediaType": {
                "type": "string",
                "enum": [
                  "beehiiv",
                  "behance",
                  "bluesky",
                  "discord",
                  "facebook",
                  "github",
                  "instagram",
                  "linkedin",
                  "linktree",
                  "mastodon",
                  "medium",
                  "patreon",
                  "pinterest",
                  "reddit",
                  "snapchat",
                  "soundcloud",
                  "substack",
                  "threads",
                  "tiktok",
                  "tumblr",
                  "twitch",
                  "twitter",
                  "vimeo",
                  "whatsapp",
                  "youtube"
                ]
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "lastScrapedAt": {
                "nullable": true
              },
              "lastScrapeFailedAt": {
                "nullable": true
              },
              "isScraping": {
                "type": "boolean"
              }
            },
            "required": [
              "socialMediaType",
              "url",
              "lastScrapedAt",
              "lastScrapeFailedAt",
              "isScraping"
            ],
            "additionalProperties": false
          }
        },
        "guestBio": {
          "nullable": true,
          "type": "object",
          "properties": {
            "additionalContext": {
              "nullable": true,
              "type": "string"
            },
            "areasOfExpertise": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "goals": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "longBio": {
              "type": "string"
            },
            "shortBio": {
              "type": "string"
            },
            "thingsToAvoid": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "topicsToDiscuss": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "additionalContext",
            "areasOfExpertise",
            "goals",
            "longBio",
            "shortBio",
            "thingsToAvoid",
            "topicsToDiscuss"
          ],
          "additionalProperties": false
        },
        "publicViewSettings": {
          "nullable": true,
          "type": "object",
          "properties": {
            "displayLinkedIn": {
              "type": "boolean"
            },
            "displaySocials": {
              "type": "boolean"
            },
            "displayPreviousPodcastAppearances": {
              "type": "boolean"
            },
            "marketingLetterMarkdownText": {
              "nullable": true,
              "type": "string"
            },
            "publicSlug": {
              "nullable": true,
              "type": "string"
            }
          },
          "required": [
            "displayLinkedIn",
            "displaySocials",
            "displayPreviousPodcastAppearances",
            "marketingLetterMarkdownText",
            "publicSlug"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "projectId",
        "projectSlug",
        "guestProfileId",
        "guestProfileSlug",
        "publicSlug",
        "name",
        "status",
        "createdAt",
        "updatedAt",
        "documents",
        "listedPodcastsCount",
        "bookingUrl",
        "companyName",
        "email",
        "firstName",
        "lastName",
        "onePagerUrl",
        "phone",
        "websiteUrl",
        "imageUrl",
        "createdBy",
        "socialMediaLinks",
        "guestBio",
        "publicViewSettings"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "status",
    "data"
  ],
  "additionalProperties": false
}
```

---

## See also

- All endpoints in one file: https://www.podengine.ai/api-docs/llms.txt
- Full reference with every schema inlined: https://www.podengine.ai/api-docs/llms-full.txt
- OpenAPI 3.1 spec: https://www.podengine.ai/api-docs/openapi.json
- Get an API key: https://www.podengine.ai/get-started
- Support: support@podengine.ai