Responds with a status code picked at random from a weighted pool

GETPOSTPUTPATCHDELETEHEADOPTIONShttps://api.testingapis.com/api/status/random

Accepts any verb. The X-Status-Pool response header shows the parsed pool.

Parameters 1

Name	Type	Description
`codes`	query · string	Comma-separated code[:weight] entries, e.g. 200:3,500:1 (200 is three times as likely). Codes must be 200-599, weights 1-100 (default 1), at most 20 entries. Default pool: 200,201,400,404,500.

Responses

200: Or whichever code was drawn; the body and headers match /api/status/{code}.
400: Invalid code, weight or pool size.

Example

Request

curl -X GET "https://api.testingapis.com/api/status/random?codes=200:3,500:1"

Response200 OK

X-Status-Pool: 200:3,500:1

{
  "status": 200,
  "statusText": "OK",
  "category": "success",
  "message": "This is a 200 response. Use /api/status/{code} to request any status."
}

Try it

api.testingapis.com

curl 'https://api.testingapis.com/api/status/random?codes=200%3A3%2C500%3A1'

const res = await fetch("https://api.testingapis.com/api/status/random?codes=200%3A3%2C500%3A1");
console.log(res.status, await res.text());

// The shape of the example response in the docs.
type ApiResponse = {
  status: number;
  statusText: string;
  category: string;
  message: string;
};

const res = await fetch("https://api.testingapis.com/api/status/random?codes=200%3A3%2C500%3A1");
const body = (await res.json()) as ApiResponse;
console.log(res.status, body);

import requests

res = requests.get("https://api.testingapis.com/api/status/random?codes=200%3A3%2C500%3A1")
print(res.status_code, res.text)

using var client = new HttpClient();
using var response = await client.GetAsync("https://api.testingapis.com/api/status/random?codes=200%3A3%2C500%3A1");
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.testingapis.com/api/status/random?codes=200%3A3%2C500%3A1"))
                .GET()
                .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.testingapis.com/api/status/random?codes=200%3A3%2C500%3A1", nil)
	if err != nil {
		panic(err)
	}
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(res.StatusCode, string(data))
}

https://api.testingapis.com/api/status/random?codes=200%3A3%2C500%3A1

Query

codesstring