> ## Documentation Index > Fetch the complete documentation index at: https://docs.mailglyph.com/llms.txt > Use this file to discover all available pages before exploring further. # List email validation credit ledger > List recent email validation credit ledger entries for the project attached to your secret API key. ## OpenAPI ````yaml openapi.json GET /v1/verification-credits/ledger openapi: 3.0.3 info: title: MailGlyph API description: >- Email platform API for transactional emails, campaigns, and marketing automation version: 1.0.0 contact: name: MailGlyph Support url: https://mailglyph.com servers: - url: https://api.mailglyph.com description: Production server security: - ApiKeyAuth: [] tags: - name: Public API description: Public API endpoints for sending emails and tracking events - name: Events description: Event ingestion and querying - name: Contacts description: Contact management operations - name: Templates description: Email template management - name: Campaigns description: Email campaign management - name: Segments description: Audience segmentation - name: Workflows description: Workflow automation paths: /v1/verification-credits/ledger: get: tags: - Public API summary: List email validation credit ledger entries description: >- Returns recent credit ledger entries for the project attached to the secret API key. Raw email addresses are never returned. operationId: listPublicVerificationCreditLedger parameters: - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 25 description: >- Maximum number of ledger entries to return. Values are clamped between 1 and 100. - name: cursor in: query required: false schema: type: string description: Cursor returned by the previous page. responses: '200': description: Paginated credit ledger entries content: application/json: schema: type: object required: - success - data properties: success: type: boolean description: Always true for successful requests. data: type: object required: - items - nextCursor properties: items: type: array items: $ref: '#/components/schemas/VerificationCreditLedgerEntry' description: >- Ledger entries ordered from newest to oldest. Entries do not include raw email addresses. nextCursor: type: string nullable: true description: >- Cursor for the next page. Omitted or null when there are no more entries. description: >- A page of email validation credit ledger entries and the cursor for the next page. examples: ledger: summary: Recent credit ledger entries value: success: true data: items: - id: 2f4c658f-4b5b-4a19-8d52-36f22d6f4566 seq: 9182 type: CONSUME creditsDelta: -1 balanceAfter: 4820 source: single_api status: Valid createdAt: '2026-06-17T10:15:30.000Z' - id: a1559ed0-3f24-4c8c-9051-50f2b813f0af seq: 9181 type: REFUND creditsDelta: 1 balanceAfter: 4821 source: single_api status: Unknown createdAt: '2026-06-17T10:13:02.000Z' - id: cc2fd351-71a3-4b76-861c-58f1f2d7d4a5 seq: 9000 type: PURCHASE creditsDelta: 5000 balanceAfter: 5000 source: stripe_checkout status: null createdAt: '2026-06-16T14:22:10.000Z' nextCursor: '9000' '401': description: Invalid or missing secret API key content: application/json: schema: $ref: '#/components/schemas/Error' security: - ApiKeyAuth: [] components: schemas: VerificationCreditLedgerEntry: type: object description: >- Append-only credit ledger entry. Email addresses are not returned in ledger responses. required: - id - seq - type - creditsDelta - balanceAfter - createdAt properties: id: type: string format: uuid description: Unique ledger entry ID. example: 2f4c658f-4b5b-4a19-8d52-36f22d6f4566 seq: type: integer description: Monotonic ledger sequence number used for cursor pagination. example: 9182 type: type: string enum: - PURCHASE - CONSUME - REFUND - ADJUSTMENT description: >- Ledger entry type. PURCHASE adds credits, CONSUME reserves/spends a credit for email validation, REFUND returns a credit for an Unknown result, and ADJUSTMENT is an administrative correction. example: CONSUME creditsDelta: type: integer description: >- Signed credit change for this entry. Purchases and refunds are positive; email validation consumption is negative. example: -1 balanceAfter: type: integer minimum: 0 description: >- Project credit balance immediately after this ledger entry was written. example: 4820 source: type: string nullable: true description: >- Origin of the ledger entry, such as single_api, single_tool, bulk, or stripe_checkout. example: single_api status: type: string nullable: true enum: - Valid - Invalid - Unknown - Catch All - Grey-listed - null description: >- Validation status associated with the entry when available. Purchase entries usually have null status. example: Valid createdAt: type: string format: date-time description: Time when the ledger entry was created. example: '2026-06-17T10:15:30.000Z' Error: type: object properties: code: type: integer error: type: string message: type: string time: type: integer securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: API Key description: >- API Key authentication. **Secret keys (sk_*)** are required for all endpoints except `/v1/track`. **Public keys (pk_*)** only work with the `/v1/track` endpoint for client-side event tracking. Workspaces can have multiple active keys, and sender-domain operations enforce per-key domain scope when configured. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.