---
title: "Disposable-only check (query string variant)"
method: GET
path: "/v1/verify/disposable"
tags: ["Verification"]
---

# Disposable-only check (query string variant)

`GET /v1/verify/disposable`

## Request

- Base URL: `https://api.billionverify.com`
- URL: `https://api.billionverify.com/v1/verify/disposable`
- Auth: API key in header `BV-API-KEY`

Same semantics as `POST /v1/verify/disposable` but accepts the email
in the query string for easy form-validation usage from the browser.

## Query parameters

- `email` string, email, required

## Response `200`

Disposable check completed

- object
  - `success` boolean
  - `code` string
  - `message` string
  - `data` object
    - `email` string
    - `domain` string
    - `is_disposable` boolean
    - `checked_at` string, date-time

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - invalid or missing API key
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/billionverify/apis/billionverify-api.md) · [All operations](https://skmtc.dev/billionverify/apis/billionverify-api/llms.txt) · [OpenAPI document](https://skmtc.dev/billionverify/apis/billionverify-api/revisions/00762347dc27?raw)