---
title: "Submit the account's one lifetime Trial Credit request"
method: POST
path: "/trial-credit-request"
tags: ["Trial Credits"]
---

# Submit the account's one lifetime Trial Credit request

`POST /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` and API key in header `X-CSRF-Token`

The configured grant and onboarding use case are snapshotted when the request is created.

## Headers

- `Idempotency-Key` string, required

## Request body

- object

## Response `201`

Trial Credit request created and automatically approved for eligible verified accounts, regardless of email provider

- 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
- `403`: Authenticated but not permitted, or CSRF validation failed
- `409`: Resource state or idempotency conflict
- `422`: Request validation failed
- `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)