---
title: "List requests"
method: GET
path: "/requests"
tags: ["Requests"]
---

# List requests

`GET /requests`

## Request

- The document declares no server URL.
- Auth: HTTP basic

Lists the user's requests in descending order; newest first. You can limit the number of returned entries (defautls to 10).

## Query parameters

- `limit` integer

## Response `200`

Success

- ListRequestsResponse
  - `api_version` string, required
  - `requests` Request[], required
    - `request_id` string, required: UUID of the request.
    - `name` string, required: A free form string that only serves as a reference for the requester. Does not need to be unique.
    - `request_type` 'web' | 'mail', required
    - `status` 'registering' | 'running' | 'generating' | 'done' | 'cancelled' | 'error', required: * `registering` - Registering domains. * `running` - Domains are being tested. * `generating` - Report is being generated. * `done` - Results ready. * `cancelled` - Cancelled by the user. * `error` - Error registering domains.
    - `submit_date` string, date-time, required
    - `finished_date` string, date-time, required: Only set when the tests are completed.

## Other responses

- `400`: Bad request
- `401`: Unauthorised
- `500`: General server error

---

[API](https://skmtc.dev/internetstandards/apis/override-this-value-in-internetnl-batch-api-doc-conf-py.md) - [All operations](https://skmtc.dev/internetstandards/apis/override-this-value-in-internetnl-batch-api-doc-conf-py/llms.txt) - [OpenAPI document](https://skmtc.dev/internetstandards/apis/override-this-value-in-internetnl-batch-api-doc-conf-py/revisions/04dfb2002730?raw)