Searches

getSearchResult

get

This method returns the result of a search operation, given its TGUID.

Path parameters

tguidstringRequired

Global unique ID of the transaction.

Responses

200

OK

application/json

400

Validation Error

application/json

500

Internal Error

application/json

get

/people/searches/{tguid}

HTTPcURLJavaScriptPython

GET /gbds/v2/people/searches/{tguid} HTTP/1.1
Host: <ip>:8085
Accept: */*

{
  "data": {
    "status": "ENQUEUED",
    "tguid": "text",
    "candidates": [
      {
        "matchedPersonPguid": "text",
        "matchedPersonTguid": "text",
        "biometricMatches": [
          {
            "score": 1,
            "queryIndex": 1,
            "referenceIndex": 1,
            "minutia": [
              {
                "query": 1,
                "reference": 1
              }
            ]
          }
        ]
      }
    ],
    "progress": 1,
    "request": {
      "searchType": "SAME_FINGERS",
      "biometric": [
        {
          "source": "CONSOLIDATED_TEMPLATE",
          "type": "FINGERPRINT",
          "format": "PRIVATE",
          "properties": {
            "width": 1,
            "height": 1,
            "resolution": 1,
            "ratio": 1,
            "matcherId": 1,
            "extractorId": 1
          },
          "index": 1,
          "content": "text",
          "quality": 1
        }
      ],
      "keys": [
        {
          "id": "text",
          "value": "text"
        }
      ],
      "pguids": [
        "text"
      ],
      "labelFilters": [
        "text"
      ],
      "isLatentSearch": true,
      "isULSearch": true,
      "numberOfCandidates": 1,
      "classificationThreshold": 1,
      "classifications": [
        "PLAIN_ARCH"
      ],
      "singularities": "NONE",
      "latentSearchOptions": {
        "scoreThreshold": 1,
        "rotationAngleThreshold": 1
      },
      "searchOptions": {
        "biometricType": {
          "scoreThreshold": 1,
          "rotationAngleThreshold": 1,
          "matcher": "DEFAULT"
        }
      },
      "user": "text",
      "uguids": [
        "text"
      ],
      "liveness": true
    },
    "failReason": "text",
    "searchType": "SAME_FINGERS",
    "biometrics": [
      {
        "source": "CONSOLIDATED_TEMPLATE",
        "type": "FINGERPRINT",
        "format": "PRIVATE",
        "properties": {
          "width": 1,
          "height": 1,
          "resolution": 1,
          "ratio": 1,
          "matcherId": 1,
          "extractorId": 1
        },
        "index": 1,
        "content": "text",
        "quality": 1
      }
    ],
    "apiID": "text",
    "gbdsVersion": "text",
    "extractionElapsed": 1,
    "searchElapsed": 1,
    "postSearchElapsed": 1,
    "ulsearch": true,
    "latentSearch": true,
    "score": 1,
    "bonafideScore": 1
  }
}

search

post

This method performs a biometric search a returns the people that match the search criteria.

Body

application/json

Responses

201

Match, not match

application/json

202

Enqueued, processing.

application/json

400

Validation Error

application/json

404

Person does not exist (if a PGUID is provided)

application/json

422

Processing Error

application/json

500

Internal Error

application/json

post

/people/searches

HTTPcURLJavaScriptPython

POST /gbds/v2/people/searches HTTP/1.1
Host: <ip>:8085
Content-Type: application/json
Accept: */*
Content-Length: 779

{
  "data": {
    "searchType": "SAME_FINGERS",
    "biometric": [
      {
        "source": "CONSOLIDATED_TEMPLATE",
        "type": "FINGERPRINT",
        "format": "PRIVATE",
        "properties": {
          "width": 1,
          "height": 1,
          "resolution": 1,
          "ratio": 1,
          "matcherId": 1,
          "extractorId": 1
        },
        "index": 1,
        "content": "text",
        "quality": 1
      }
    ],
    "keys": [
      {
        "id": "text",
        "value": "text"
      }
    ],
    "pguids": [
      "text"
    ],
    "labelFilters": [
      "text"
    ],
    "isLatentSearch": true,
    "isULSearch": true,
    "numberOfCandidates": 1,
    "classificationThreshold": 1,
    "classifications": [
      "PLAIN_ARCH"
    ],
    "singularities": "NONE",
    "latentSearchOptions": {
      "scoreThreshold": 1,
      "rotationAngleThreshold": 1
    },
    "searchOptions": {
      "biometricType": {
        "scoreThreshold": 1,
        "rotationAngleThreshold": 1,
        "matcher": "DEFAULT"
      }
    },
    "user": "text",
    "uguids": [
      "text"
    ],
    "liveness": true
  },
  "meta": {
    "timeout": 1,
    "priority": "GOD_PRIORITY",
    "metadata": [
      {
        "key": "text"
      }
    ]
  }
}

{
  "data": {
    "status": "ENQUEUED",
    "tguid": "text",
    "score": 1,
    "bonafideScore": 1
  }
}