Convo
API ReferenceUser

Get profile and usage

Returns user profile, subscription tier, and API usage statistics.

GET
/api/v1/user/profile

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token. Generate keys in your Convo dashboard settings.

In: header

curl -X GET "https://www.itsconvo.com/api/v1/user/profile" \
  -H "Authorization: Bearer <token>"

User profile and usage stats

{
  "data": {
    "profile": {
      "name": "Alice Chen",
      "email": "alice@example.com",
      "timezone": "America/New_York",
      "language": "en",
      "profilePictureUrl": null,
      "createdAt": "2025-09-15T10:00:00.000Z"
    },
    "subscription": {
      "tier": "professional",
      "status": "active",
      "currentPeriodEnd": "2026-04-15T00:00:00.000Z"
    },
    "apiUsage": {
      "aiGenerations": {
        "used": 12,
        "limit": 100,
        "remaining": 88,
        "resetsAt": "2026-04-01T00:00:00.000Z"
      }
    }
  }
}