Cloudinary API
Cloudinary DocsGet API keys
HomeAPI ReferenceSDKsContext Plugin
People

Get person details

GET
/v1_1/{cloud_name}/people/{person_id}

Returns details of a specific recognized person. People Search must be enabled for this product environment.

Authorization

AuthorizationBasic <token>

Basic authentication using Cloudinary API Key and API Secret.

In: header

Path Parameters

cloud_name*string

The cloud name of your product environment.

person_id*string

The unique identifier of the person.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1_1/my_cloud/people/f10f893da5a1586dca6764b22514aa0d25e6b867baffc4fb43a2318a25d8e5b2"
{  "person": {    "id": "string",    "name": "string",    "status": "active",    "thumbnail": {      "asset_id": "string",      "bounding_box": [        0,        0,        0,        0      ],      "url": "http://example.com",      "resource_type": "string",      "type": "string",      "public_id": "string",      "version": 0    },    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  }}

List recognized people GET

Returns a list of all recognized people in your product environment. People Search must be enabled for this product environment.

Update a person PUT

Updates a recognized person's name, status, or thumbnail image. At least one of name, status, or thumbnail_asset_id must be provided. People Search must be enabled for this product environment.