Skip to main content
LTV.ai exposes a GraphQL API via Apollo Server for customer-facing operations.

Endpoints

EndpointDescription
POST /graphqlMain GraphQL API
POST /graphql-subscriptionGraphQL subscriptions (WebSocket)

Authentication

GraphQL requests are authenticated using the same JWT guards as REST endpoints. Include the token in the Authorization header:
Authorization: Bearer <token>

Resolvers

The GraphQL API includes the following resolvers:
ResolverDescription
CustomerResolverCustomer profile queries
BillingResolverBilling and subscription mutations
OTPCodeResolverOne-time password authentication

Rate Limiting

GraphQL operations are rate limited via GqlThrottlerGuard backed by Redis. Limits are applied per-user and per-IP.

Custom Scalars

The API uses custom GraphQL scalars for:
  • DateTime - ISO 8601 date-time strings
  • JSON - Arbitrary JSON data
  • UUID - UUID v4 strings