Get a guest profile by ID

Guests · GET /v1/guests/:id

Get a guest profile by ID

GET/v1/guests/:id

Request

curl https://api.repull.dev/v1/guests/789 \
  -H "Authorization: Bearer $REPULL_API_KEY"

Response

{
  "id": "123",
  "displayName": "Example",
  "displayNameLong": "Example",
  "avatarUrl": "https://example.com/...",
  "language": "Example text",
  "country": null,
  "phone": "+15550000000",
  "email": "guest@example.com",
  "totalReservations": 0,
  "totalRevenue": "Example text",
  "currency": "USD",
  "isBlacklisted": false,
  "blacklistedReason": null,
  "riskLevel": "low",
  "verificationLevel": 0,
  "createdAt": "2026-06-01T12:00:00.000Z",
  "contacts": [
    {
      "type": "email",
      "value": "Example text",
      "verified": false,
      "isPrimary": true,
      "lastUsed": null
    }
  ],
  "flags": [],
  "notes": [],
  "reservationsSummary": {
    "total": 0,
    "future": 0,
    "past": 0,
    "cancelled": 0
  }
}

Captured from a real response. Regenerated on every release, and CI fails if this shape stops matching the API.

AI