Face Client

azure · Cloud

Cloud No Auth Free & Open cloud

An API for face detection, verification, and identification.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET LargePersonGroup_List

List all existing large person groups’ largePersonGroupId, name, userData and recognitionModel. * Large person groups are stored in alphabetical order of largePersonGroupId. * "start" parameter (string, optional) is a user-provided largePersonGroupId value that returned entries have larger ids

https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/largepersongroups?top=1000&start=example&returnRecognitionModel=false

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/largepersongroups?top=1000&start=example&returnRecognitionModel=false"

import requests
params = {
    "top": "1000",
    "start": "example",
    "returnRecognitionModel": "false"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/largepersongroups",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/largepersongroups');
url.searchParams.set('top', '1000');
url.searchParams.set('start', 'example');
url.searchParams.set('returnRecognitionModel', 'false');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

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

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/largepersongroups")
	q := baseURL.Query()
	q.Set("top", "1000")
	q.Set("start", "example")
	q.Set("returnRecognitionModel", "false")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/largepersongroups")
uri.query = URI.encode_www_form({
  "top" => "1000",
  "start" => "example",
  "returnRecognitionModel" => "false"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/largepersongroups?" . http_build_query([
    "top" => "1000",
    "start" => "example",
    "returnRecognitionModel" => "false"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET PersonGroup_List

List person groups’ personGroupId, name, userData and recognitionModel. * Person groups are stored in alphabetical order of personGroupId. * "start" parameter (string, optional) is a user-provided personGroupId value that returned entries have larger ids by string comparison. "start" set to em

https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/persongroups?top=1000&start=example&returnRecognitionModel=false

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/persongroups?top=1000&start=example&returnRecognitionModel=false"

import requests
params = {
    "top": "1000",
    "start": "example",
    "returnRecognitionModel": "false"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/persongroups",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/persongroups');
url.searchParams.set('top', '1000');
url.searchParams.set('start', 'example');
url.searchParams.set('returnRecognitionModel', 'false');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

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

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/persongroups")
	q := baseURL.Query()
	q.Set("top", "1000")
	q.Set("start", "example")
	q.Set("returnRecognitionModel", "false")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/persongroups")
uri.query = URI.encode_www_form({
  "top" => "1000",
  "start" => "example",
  "returnRecognitionModel" => "false"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/persongroups?" . http_build_query([
    "top" => "1000",
    "start" => "example",
    "returnRecognitionModel" => "false"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Snapshot_List

List all accessible snapshots with related information, including snapshots that were taken by the user, or snapshots to be applied to the user (subscription id was included in the applyScope in Snapshot - Take).

https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/snapshots?type=FaceList&applyScope=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/snapshots?type=FaceList&applyScope=example"

import requests
params = {
    "type": "FaceList",
    "applyScope": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/snapshots",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/snapshots');
url.searchParams.set('type', 'FaceList');
url.searchParams.set('applyScope', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

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

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/snapshots")
	q := baseURL.Query()
	q.Set("type", "FaceList")
	q.Set("applyScope", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/snapshots")
uri.query = URI.encode_www_form({
  "type" => "FaceList",
  "applyScope" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/azure.com/cognitiveservices-Face/1.0/snapshots?" . http_build_query([
    "type" => "FaceList",
    "applyScope" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Face Client?

Face Client is a Cloud API. Developers commonly use cloud APIs for:

provisioning and managing cloud infrastructure
automating deployments and container orchestration
monitoring uptime and performance metrics
managing storage buckets and databases
setting up auto-scaling and load balancing

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Face Client is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide

Open documentation ↗