Try DamageBDD: URL to an executable Gherkin test

Start verifying API behaviour from a public HTTPS URL. Generate a Gherkin scenario, optionally run an approved first check, review a shareable report and schedule more tests.

Verify a public API endpoint in minutes

Do not have a feature file yet? Open the instant API verification page, paste a public HTTPS URL such as https://example.com/health, and choose Generate test. The draft contains runnable DamageBDD HTTP steps. You can review, copy or download it without creating an account.

Feature: First API verification

  Scenario: GET endpoint returns HTTP 200
    Given I am using server "https://example.com"
    When I make a GET request to "/health"
    Then the response status must be "200"

The example is illustrative, not evidence that a test has passed. Replace the URL and assertion with the behaviour expected of your actual service.

First execution, evidence and scheduling

The current quickstart generates a deterministic scenario without contacting its target. A separate Run click performs a single read-only HTTP status check, only if the server operator has enabled free trials and approved that exact HTTPS hostname and path. Otherwise, generation and download still work, but free execution is unavailable.

Eligible trials can produce a time-limited, shareable verification report. Reports describe the observed response; they do not establish full application correctness. Do not put private information or credentials in the URL or share sensitive paths. The MVP supports HTTPS port 443 and simple paths without URL credentials, query strings or fragments.

For continuing regression checks, sign in to the DamageBDD dashboard and schedule the generated scenario. Recurring execution uses normal account authorisation, execution credits and domain policies; a free first check does not grant free scheduled runs.

Participate in verification

For programmatic testing, use the Python quickstart for humans, bots and LLM agents. It covers keypairs, authentication, DAMAGE funding through the Lightning API or Coinstore, paid execution and report inspection. The account and settlement requirements for paid execution are separate from an approved free trial.

Test writers can explore the user manual and the step-module reference. Operators can install a Damage node to help provide verification capacity. Source code is available from the DamageBDD repository.

Search documentation

Search titles, summaries and document paths.