Collections are groups of registered `Persons`. You can use collections to organize your registered persons and to search for persons within a specific collection. You can also use collections to manage access to your registered persons. For example, you can create a collection for each of your customers/organization sub-units and only allow them to search for persons in their own collection.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/seventh-sense-collections-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: OpenCV Face Recognition Collections API
description: OpenCV Face Recognition allows you to either **manually** (through our Developer Portal UI) or **programmatically** (through our SDKs or REST API) detect, recognize, and verify faces in images.
version: 2026.07.15.0759
tags:
- name: Collections
description: Collections are groups of registered `Persons`. You can use collections to organize your registered persons and to search for persons within a specific collection. You can also use collections to manage access to your registered persons. For example, you can create a collection for each of your customers/organization sub-units and only allow them to search for persons in their own collection.
paths:
/collections:
get:
tags:
- Collections
summary: Get Collections
operationId: get_collections_collections_get
security:
- APIKeyHeader: []
parameters:
- name: skip
in: query
required: false
schema:
type: integer
minimum: 0
default: 0
title: Skip
- name: take
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 0
default: 20
title: Take
- name: order
in: query
required: false
schema:
allOf:
- $ref: '#/components/schemas/OrderEnum'
default: ASC
title: Order
- name: search
in: query
required: false
schema:
type: string
title: Search
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ListCollectionSchema'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/collections/{comma_separated_ids}:
get:
tags:
- Collections
summary: Get Collections
operationId: get_collections_collections__comma_separated_ids__get
security:
- APIKeyHeader: []
parameters:
- name: comma_separated_ids
in: path
required: true
schema:
title: Comma Separated Ids
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/CollectionSchema'
title: Response Get Collections Collections Comma Separated Ids Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/collections/person/{person_id}:
get:
tags:
- Collections
summary: Get Collections For Person
operationId: get_collections_for_person_collections_person__person_id__get
security:
- APIKeyHeader: []
parameters:
- name: person_id
in: path
required: true
schema:
title: Person Id
- name: skip
in: query
required: false
schema:
type: integer
minimum: 0
default: 0
title: Skip
- name: take
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 0
default: 20
title: Take
- name: order
in: query
required: false
schema:
allOf:
- $ref: '#/components/schemas/OrderEnum'
default: ASC
title: Order
- name: search
in: query
required: false
schema:
type: string
title: Search
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ListCollectionSchema'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/collection:
post:
tags:
- Collections
summary: Create Collection
operationId: create_collection_collection_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateCollectionSchema'
required: true
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CollectionSchema'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
patch:
tags:
- Collections
summary: Update Collection
operationId: update_collection_collection_patch
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateCollectionSchema'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CollectionSchema'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
/collection/{collection_id}:
delete:
tags:
- Collections
summary: Delete Collection
operationId: delete_collection_collection__collection_id__delete
security:
- APIKeyHeader: []
parameters:
- name: collection_id
in: path
required: true
schema:
title: Collection Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DeletedItemSchema'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- Collections
summary: Get Collection
operationId: get_collection_collection__collection_id__get
security:
- APIKeyHeader: []
parameters:
- name: collection_id
in: path
required: true
schema:
title: Collection Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CollectionSchema'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/collection/person:
post:
tags:
- Collections
summary: Add Person To A Collection
operationId: add_person_to_a_collection_collection_person_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/LinkSchema'
required: true
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/LinkSchema'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
/collection/persons:
patch:
tags:
- Collections
summary: Update Collection Person Associations
operationId: update_collection_person_associations_collection_persons_patch
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/LinksSchema'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/LinksSchema'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
/collection/person/{collection_id}/{person_id}:
delete:
tags:
- Collections
summary: Remove Person From Collection
operationId: remove_person_from_collection_collection_person__collection_id___person_id__delete
security:
- APIKeyHeader: []
parameters:
- name: collection_id
in: path
required: true
schema:
title: Collection Id
- name: person_id
in: path
required: true
schema:
title: Person Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/LinkSchema'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
DeletedItemSchema:
properties:
id:
type: string
title: Id
type: object
title: DeletedItemSchema
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
CreateCollectionSchema:
properties:
name:
type: string
maxLength: 50
minLength: 1
title: Name
description:
anyOf:
- type: string
maxLength: 100
minLength: 0
- type: 'null'
title: Description
type: object
required:
- name
title: CreateCollectionSchema
OrderEnum:
type: string
enum:
- ASC
- DESC
title: OrderEnum
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ListCollectionSchema:
properties:
count:
type: integer
title: Count
collections:
items:
$ref: '#/components/schemas/CollectionSchema'
type: array
title: Collections
type: object
required:
- count
- collections
title: ListCollectionSchema
UpdateCollectionSchema:
properties:
id:
type: string
maxLength: 36
minLength: 36
title: Id
name:
anyOf:
- type: string
maxLength: 50
minLength: 1
- type: 'null'
title: Name
description:
anyOf:
- type: string
maxLength: 100
minLength: 0
- type: 'null'
title: Description
type: object
required:
- id
title: UpdateCollectionSchema
LinksSchema:
properties:
collection_id:
type: string
maxLength: 36
minLength: 36
title: Collection Id
new_person_ids:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: New Person Ids
removed_person_ids:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Removed Person Ids
type: object
required:
- collection_id
title: LinksSchema
LinkSchema:
properties:
collection_id:
type: string
maxLength: 36
minLength: 36
title: Collection Id
person_id:
type: string
maxLength: 100
minLength: 1
title: Person Id
type: object
required:
- collection_id
- person_id
title: LinkSchema
CollectionSchema:
properties:
id:
type: string
maxLength: 36
minLength: 36
title: Id
name:
type: string
maxLength: 50
minLength: 1
title: Name
description:
anyOf:
- type: string
maxLength: 100
minLength: 0
- type: 'null'
title: Description
count:
type: integer
title: Count
create_date:
type: string
format: date-time
title: Create Date
modified_date:
type: string
format: date-time
title: Modified Date
type: object
required:
- id
- name
- count
- create_date
- modified_date
title: CollectionSchema
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: x-api-key