---
title: "Read Trial Credit eligibility and the account's lifetime request"
method: GET
path: "/trial-credit-request"
tags: ["Trial Credits"]
---

# Read Trial Credit eligibility and the account's lifetime request

`GET /trial-credit-request`

## Request

- Base URL: `https://api.flashdata.dev/v2`
- URL: `https://api.flashdata.dev/v2/trial-credit-request`
- Auth: API key in cookie `__Host-fd_session`

## Response `200`

Current eligibility, configured grant, and request state

- TrialCreditState
  - `eligible` boolean, required
  - `ineligibilityReason` 'account_inactive' | 'email_unverified' | 'onboarding_incomplete' | 'not_payg' | 'payment_history' | 'already_granted' | 'already_requested' | 'null', nullable, required
  - `grantCredits` integer, required
  - `settingsVersion` integer, required
  - `request` TrialCreditRequest, required
    - `id` string, required
    - `status` 'pending' | 'approved' | 'rejected', required
    - `requestedCredits` integer, required
    - `policyVersion` integer, required
    - `useCase` 'google_search' | 'youtube_data' | 'download' | 'null', nullable, required
    - `requestedAt` string, date-time, required
    - `reviewedAt` string, date-time, nullable, required
    - `reviewReason` string, nullable, required
    - `version` integer, required

## Other responses

- `401`: Authentication required or invalid
- `500`: An unexpected internal error occurred
- `503`: A required dependency or onboarding record is temporarily unavailable

---

[API](https://skmtc.dev/flashdata/apis/flashdata-customer-api.md) · [All operations](https://skmtc.dev/flashdata/apis/flashdata-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flashdata/apis/flashdata-customer-api/revisions/109179fe9313?raw)