Create up to 100 people in one request

POSThttps://api.testingapis.com/api/People/bulkSign in to see this endpoint's URL

All items are validated first; if any item is invalid nothing is stored and the error names its index.

Request body

Optional. application/json, text/json, application/*+json, application/xml, text/xml, application/*+xml. Model: Person. JSON array of 1 to 100 records.

Example body

[
  {
    "firstName": "Aisha",
    "lastName": "Khan",
    "username": "akhan",
    "email": "akhan@example.com",
    "gender": "female",
    "dateOfBirth": "1991-04-12",
    "phone": "+1-555-200-3000",
    "avatar": "https://i.pravatar.cc/150?img=1",
    "address": {
      "street": "42 Baker Street",
      "city": "London",
      "state": "England",
      "zip": "NW1 6XE",
      "country": "United Kingdom",
      "geo": {"lat": 51.5237, "lng": -0.1585}
    },
    "company": {"name": "Nimbus Cloud Systems", "title": "Product Manager"}
  }
]

Responses

200: OK
201: Created; returns { message, data } with every generated ID.
400: The array is empty, has more than 100 items, or an item fails validation.

Example

Request

curl -X POST "https://api.testingapis.com/api/People/bulk?ids=22,23" \
  -H "Content-Type: application/json" \
  -d '[{"firstName": "Aisha", "lastName": "Khan", "username": "akhan", "email": "akhan@example.com", "gender": "female", "dateOfBirth": "1991-04-12", "phone": "+1-555-200-3000", "avatar": "https://i.pravatar.cc/150?img=1", "address": {"street": "42 Baker Street", "city": "London", "state": "England", "zip": "NW1 6XE", "country": "United Kingdom", "geo": {"lat": 51.5237, "lng": -0.1585}}, "company": {"name": "Nimbus Cloud Systems", "title": "Product Manager"}}]' \
  -H "X-TestingApis-Key: YOUR_API_KEY"

Response201 Created

{
  "message": "1 person record(s) created",
  "data": [
    {
      "id": 25,
      "firstName": "Aisha",
      "lastName": "Khan",
      "username": "akhan",
      "email": "akhan@example.com",
      "gender": "female",
      "dateOfBirth": "1991-04-12",
      "phone": "+1-555-200-3000",
      "avatar": "https://i.pravatar.cc/150?img=1",
      "address": {
… (11 more lines)

The parameters, request and response examples and the live Try it panel for this endpoint are for signed-in members. Accounts are free and take a few seconds to create.

Try itSign-in requiredUses your key

api.testingapis.com

curl -X POST 'https://api.testingapis.com/api/People/bulk?ids=22%2C23' \
  -H 'Content-Type: application/json' \
  -H 'X-TestingApis-Key: YOUR_API_KEY' \
  -d '[{"firstName": "Aisha", "lastName": "Khan", "username": "akhan", "email": "akhan@example.com", "gender": "female", "dateOfBirth": "1991-04-12", "phone": "+1-555-200-3000", "avatar": "https://i.pravatar.cc/150?img=1", "address": {"street": "42 Baker Street", "city": "London", "state": "England", "zip": "NW1 6XE", "country": "United Kingdom", "geo": {"lat": 51.5237, "lng": -0.1585}}, "company": {"name": "Nimbus Cloud Systems", "title": "Product Manager"}}]'

const res = await fetch("https://api.testingapis.com/api/People/bulk?ids=22%2C23", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
  body: "[{\"firstName\": \"Aisha\", \"lastName\": \"Khan\", \"username\": \"akhan\", \"email\": \"akhan@example.com\", \"gender\": \"female\", \"dateOfBirth\": \"1991-04-12\", \"phone\": \"+1-555-200-3000\", \"avatar\": \"https://i.pravatar.cc/150?img=1\", \"address\": {\"street\": \"42 Baker Street\", \"city\": \"London\", \"state\": \"England\", \"zip\": \"NW1 6XE\", \"country\": \"United Kingdom\", \"geo\": {\"lat\": 51.5237, \"lng\": -0.1585}}, \"company\": {\"name\": \"Nimbus Cloud Systems\", \"title\": \"Product Manager\"}}]",
});
console.log(res.status, await res.text());

const res = await fetch("https://api.testingapis.com/api/People/bulk?ids=22%2C23", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
  body: "[{\"firstName\": \"Aisha\", \"lastName\": \"Khan\", \"username\": \"akhan\", \"email\": \"akhan@example.com\", \"gender\": \"female\", \"dateOfBirth\": \"1991-04-12\", \"phone\": \"+1-555-200-3000\", \"avatar\": \"https://i.pravatar.cc/150?img=1\", \"address\": {\"street\": \"42 Baker Street\", \"city\": \"London\", \"state\": \"England\", \"zip\": \"NW1 6XE\", \"country\": \"United Kingdom\", \"geo\": {\"lat\": 51.5237, \"lng\": -0.1585}}, \"company\": {\"name\": \"Nimbus Cloud Systems\", \"title\": \"Product Manager\"}}]",
});
const body: string = await res.text();
console.log(res.status, body);

import requests

res = requests.post(
    "https://api.testingapis.com/api/People/bulk?ids=22%2C23",
    headers={
        "Content-Type": "application/json",
        "X-TestingApis-Key": "YOUR_API_KEY",
    },
    data="[{\"firstName\": \"Aisha\", \"lastName\": \"Khan\", \"username\": \"akhan\", \"email\": \"akhan@example.com\", \"gender\": \"female\", \"dateOfBirth\": \"1991-04-12\", \"phone\": \"+1-555-200-3000\", \"avatar\": \"https://i.pravatar.cc/150?img=1\", \"address\": {\"street\": \"42 Baker Street\", \"city\": \"London\", \"state\": \"England\", \"zip\": \"NW1 6XE\", \"country\": \"United Kingdom\", \"geo\": {\"lat\": 51.5237, \"lng\": -0.1585}}, \"company\": {\"name\": \"Nimbus Cloud Systems\", \"title\": \"Product Manager\"}}]",
)
print(res.status_code, res.text)

using System.Net.Http.Headers;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://api.testingapis.com/api/People/bulk?ids=22%2C23");
request.Headers.TryAddWithoutValidation("X-TestingApis-Key", "YOUR_API_KEY");
request.Content = new StringContent("[{\"firstName\": \"Aisha\", \"lastName\": \"Khan\", \"username\": \"akhan\", \"email\": \"akhan@example.com\", \"gender\": \"female\", \"dateOfBirth\": \"1991-04-12\", \"phone\": \"+1-555-200-3000\", \"avatar\": \"https://i.pravatar.cc/150?img=1\", \"address\": {\"street\": \"42 Baker Street\", \"city\": \"London\", \"state\": \"England\", \"zip\": \"NW1 6XE\", \"country\": \"United Kingdom\", \"geo\": {\"lat\": 51.5237, \"lng\": -0.1585}}, \"company\": {\"name\": \"Nimbus Cloud Systems\", \"title\": \"Product Manager\"}}]");
request.Content.Headers.ContentType = MediaTypeHeaderValue.Parse("application/json");
using var response = await client.SendAsync(request);
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/People/bulk?ids=22%2C23"))
                .header("X-TestingApis-Key", "YOUR_API_KEY")
                .header("Content-Type", "application/json")
                .method("POST", HttpRequest.BodyPublishers.ofString("[{\"firstName\": \"Aisha\", \"lastName\": \"Khan\", \"username\": \"akhan\", \"email\": \"akhan@example.com\", \"gender\": \"female\", \"dateOfBirth\": \"1991-04-12\", \"phone\": \"+1-555-200-3000\", \"avatar\": \"https://i.pravatar.cc/150?img=1\", \"address\": {\"street\": \"42 Baker Street\", \"city\": \"London\", \"state\": \"England\", \"zip\": \"NW1 6XE\", \"country\": \"United Kingdom\", \"geo\": {\"lat\": 51.5237, \"lng\": -0.1585}}, \"company\": {\"name\": \"Nimbus Cloud Systems\", \"title\": \"Product Manager\"}}]"))
                .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

package main

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

func main() {
	body := strings.NewReader("[{\"firstName\": \"Aisha\", \"lastName\": \"Khan\", \"username\": \"akhan\", \"email\": \"akhan@example.com\", \"gender\": \"female\", \"dateOfBirth\": \"1991-04-12\", \"phone\": \"+1-555-200-3000\", \"avatar\": \"https://i.pravatar.cc/150?img=1\", \"address\": {\"street\": \"42 Baker Street\", \"city\": \"London\", \"state\": \"England\", \"zip\": \"NW1 6XE\", \"country\": \"United Kingdom\", \"geo\": {\"lat\": 51.5237, \"lng\": -0.1585}}, \"company\": {\"name\": \"Nimbus Cloud Systems\", \"title\": \"Product Manager\"}}]")
	req, err := http.NewRequest("POST", "https://api.testingapis.com/api/People/bulk?ids=22%2C23", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-TestingApis-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	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))
}

POSThttps://api.testingapis.com/api/People/bulk?ids=22%2C23

Create up to 100 people in one request

Request body

Responses

Example

Related