Exceptions
This method returns an exception for a given person/transaction.
Path parameters
tguidstringRequired
Global unique ID of the transaction.
pguidstringRequired
Global unique ID of the person.
Responses
200
OK
application/json
404
Enrollment transaction does not exist, the exception does not exist
application/json
500
Internal Error
application/json
get
/exceptions/{tguid}/{pguid}GET /gbds/v2/exceptions/{tguid}/{pguid} HTTP/1.1
Host: <ip>:8085
Accept: */*
{
"data": {
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
}This method returns a list of exceptions that match the given search criteria.
Query parameters
startDateinteger · int64Optional
Minimum timestamp, in milliseconds.
endDateinteger · int64Optional
Maximum timestamp, in milliseconds.
userstringOptional
ID of the user.
keysstring[]Optional
Array of keys that uniquely identify the person. This field can be an expression.
The following structure can be used for both keys and biographics:
| Format | Description |
|---|---|
<id>:<value> |
Searches for exceptions with incoming or reference keys/biographics with the passed id and value. |
<id>: |
Searches for exceptions with incoming or reference keys/biographics with the id and any value. |
:<value> |
Searches for exceptions with incoming or reference keys/biographics with the value and any id. |
From the second keys/biographics item onwards, before each id or value, you can include an operator:
[and]: performs an AND operation with the previous item.[or]: performs an OR operation with the previous item.
These operators may be applied to both keys and biographics.
On every operation on an id or value, the default behavior will be to test for exact matches. To change this behavior, you can include a modifier at the end of the id or value:
[exact]: tests for exact matches. This is the default behavior, the same as not including any modifier.[atstart]: searches for content that starts with the passed id/value.[atend]: searches for content that ends with the passed id/value.[anywhere]: searches for content that contains the passed id/value.
IMPORTANT: Be careful when using modifiers other than [exact]. They can slow down the search.
Examples:
keys=cpf:001&biographics=namekeys=cpf:001&keys=[or]cpf:002keys=cpf:00[atstart]
biographicsstring[]Optional
Biographic data of the person. This field can be an expression.
For expressions, use the same structure described in the keys parameter.
labelsstring[]Optional
A list of labels of the person.
pageIndexinteger · int32Optional
pageSizeinteger · int32Optional
locekdUserstringOptional
prioritybooleanOptional
targetstring · enumOptionalPossible values:
Responses
200
OK
application/json
400
Validation Error
application/json
500
Internal Error
application/json
get
/exceptionsGET /gbds/v2/exceptions HTTP/1.1
Host: <ip>:8085
Accept: */*
{
"data": [
{
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"pagination": {
"total": 1,
"count": 1,
"pageSize": 1,
"currentPage": 1,
"totalPages": 1
}
}This method removes the assignment of a user to an exception.
Path parameters
tguidstringRequired
Global unique ID of the transaction.
pguidstringRequired
Global unique ID of the person.
Responses
204
Deleted
application/json
Responseobject
404
Exception does not exist
application/json
500
Internal Error
application/json
delete
/exceptions/{tguid}/{pguid}/usersDELETE /gbds/v2/exceptions/{tguid}/{pguid}/users HTTP/1.1
Host: <ip>:8085
Accept: */*
{}This method returns the exception list from a given exception.
Path parameters
tguidstringRequired
Global unique ID of the transaction.
Responses
200
OK
application/json
404
Enrollment transaction does not exist
application/json
500
Internal Error
application/json
get
/exceptions/{tguid}GET /gbds/v2/exceptions/{tguid} HTTP/1.1
Host: <ip>:8085
Accept: */*
{
"data": [
{
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"pagination": {
"total": 1,
"count": 1,
"pageSize": 1,
"currentPage": 1,
"totalPages": 1
}
}This method assigns an exception to a given user.
Path parameters
tguidstringRequired
Global unique ID of the transaction.
pguidstringRequired
Global unique ID of the person.
userstringRequired
ID of the user.
Responses
201
OK
application/json
Responseobject
404
Exception does not exist
application/json
500
Internal Error
application/json
put
/exceptions/{tguid}/{pguid}/users/{user}PUT /gbds/v2/exceptions/{tguid}/{pguid}/users/{user} HTTP/1.1
Host: <ip>:8085
Accept: */*
{}This method returns the status of the treatment given to a specific transaction.
Path parameters
tguidstringRequired
Global unique ID of the transaction.
Responses
200
Ok, enqueued, Error
application/json
400
Validation Error
application/json
404
Exception treatment transaction does not exist
application/json
500
Internal Error
application/json
get
/exceptions/treatment/{tguid}GET /gbds/v2/exceptions/treatment/{tguid} HTTP/1.1
Host: <ip>:8085
Accept: */*
{
"status": "OK",
"treatTguid": "text",
"failReason": "text"
}This method provides the treatment for a given exception.
Body
Responses
201
Enqueued
application/json
202
OK
application/json
400
Validation Error
application/json
403
User not authorized to treat exception.
application/json
404
Exception treatment transaction does not exist, exception does not exist
application/json
500
Internal Error
application/json
post
/exceptions/treatmentPOST /gbds/v2/exceptions/treatment HTTP/1.1
Host: <ip>:8085
Content-Type: application/json
Accept: */*
Content-Length: 220
{
"data": {
"enrollTguid": "text",
"exceptionPguid": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"referenceIndexes": [
1
]
},
"meta": {
"timeout": 1,
"discardReference": true
}
}{
"status": "OK",
"treatTguid": "text",
"failReason": "text"
}Path parameters
pguidstringRequired
Global unique ID of the person.
Responses
200
OK
application/json
400
Validation Error
application/json
500
Internal Error
application/json
get
/exceptions/byEntrant/{pguid}GET /gbds/v2/exceptions/byEntrant/{pguid} HTTP/1.1
Host: <ip>:8085
Accept: */*
{
"data": [
{
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"pagination": {
"total": 1,
"count": 1,
"pageSize": 1,
"currentPage": 1,
"totalPages": 1
}
}Path parameters
pguidstringRequired
Global unique ID of the person.
Responses
200
OK
application/json
400
Validation Error
application/json
500
Internal Error
application/json
get
/exceptions/byReference/{pguid}GET /gbds/v2/exceptions/byReference/{pguid} HTTP/1.1
Host: <ip>:8085
Accept: */*
{
"data": [
{
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"pagination": {
"total": 1,
"count": 1,
"pageSize": 1,
"currentPage": 1,
"totalPages": 1
}
}Sets or clears the priority flag for a specific exception identified by transaction GUID (tguid) and person GUID (pguid). When the priority path parameter is true, the exception—and its group—is prioritized; when false, the priority is removed. Returns 202 Accepted.
Path parameters
tguidstringRequired
pguidstringRequired
prioritybooleanRequired
Responses
202
ACCEPTED
application/json
Responseobject
put
/exceptions/{tguid}/{pguid}/priority/{priority}PUT /gbds/v2/exceptions/{tguid}/{pguid}/priority/{priority} HTTP/1.1
Host: <ip>:8085
Accept: */*
202
ACCEPTED
{}Unlocks a previously locked biometric candidate for a given transaction GUID (tguid), person GUID (pguid) and biometric index. When API security is enabled, the user is derived from the token; otherwise the user must be provided. Returns 204 No Content.
Path parameters
tguidstringRequired
pguidstringRequired
indexinteger · int32Required
Responses
204
NO CONTENT
application/json
Responseobject
delete
/exceptions/{tguid}/{pguid}/biometric/{index}/userDELETE /gbds/v2/exceptions/{tguid}/{pguid}/biometric/{index}/user HTTP/1.1
Host: <ip>:8085
Accept: */*
204
NO CONTENT
{}Unlocks a previously locked biometric candidate for a given transaction GUID (tguid), person GUID (pguid) and biometric index, specifying the user that holds the lock. Returns 204 No Content.
Path parameters
tguidstringRequired
pguidstringRequired
indexinteger · int32Required
userstringRequired
Responses
204
NO CONTENT
application/json
Responseobject
delete
/exceptions/{tguid}/{pguid}/biometric/{index}/user/{user}DELETE /gbds/v2/exceptions/{tguid}/{pguid}/biometric/{index}/user/{user} HTTP/1.1
Host: <ip>:8085
Accept: */*
204
NO CONTENT
{}Applies a decision to all exceptions within a group. The request body must provide the group GUID (gguid), user (overwritten by the security token when API security is enabled), a list of permissions, comments, timeout, a decision (KEEP or REJECT) and decision parameters: keys (list of {id, value} pairs), biographics (list of {id, value} pairs), labels, keepTransactions and removeTransactions. Responds with 202 Accepted and data containing a status of PENDING or OK. PENDING indicates the treatment requires a follow‑up decision, while OK indicates the group was treated successfully. When status is OK and the decision is KEEP, the response may include newTguid, newPguid and a list of keptTguids.
Body
gguidstringOptional
userstringOptional
commentsstringOptional
timeoutinteger · int32Optional
decisionstring · enumOptionalPossible values:
permissionsstring[]Optional
Responses
202
ACCEPTED
application/json
post
/exceptions/treatment/groupPOST /gbds/v2/exceptions/treatment/group HTTP/1.1
Host: <ip>:8085
Content-Type: application/json
Accept: */*
Content-Length: 278
{
"gguid": "text",
"user": "text",
"comments": "text",
"timeout": 1,
"decision": "APPROVE",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"permissions": [
"text"
]
}202
ACCEPTED
{
"status": "OK",
"treatTguid": "text",
"failReason": "text"
}Retrieves the treatment result for an exception group identified by its gguid. Returns 202 Accepted with the same data structure as the group treatment response, enabling clients to poll for the final status.
Path parameters
gguidstringRequired
Responses
202
ACCEPTED
application/json
get
/exceptions/treatment/group/{gguid}GET /gbds/v2/exceptions/treatment/group/{gguid} HTTP/1.1
Host: <ip>:8085
Accept: */*
202
ACCEPTED
{
"status": "OK",
"treatTguid": "text",
"failReason": "text"
}Completes the treatment of a group left in PENDING status. The request must include the group GUID (gguid), user (overwritten by the security token when API security is enabled), permissions, a pendingTreatment flag (ACCEPT or REJECT), comments and an optional timeout. Responds with 202 Accepted and a data object containing status. A status of OK means the pending treatment was accepted and processed; a status of BIOGRAPHIC or BIOMETRIC_INCONCLUSIVE means the group returns to analysis. When treatment is accepted, newTguid, newPguid and keptTguids may be included.
Body
gguidstringOptional
pendingTreatmentstring · enumOptionalPossible values:
userstringOptional
commentsstringOptional
timeoutinteger · int32Optional
permissionsstring[]Optional
Responses
202
ACCEPTED
application/json
post
/exceptions/treatment/group/pendingPOST /gbds/v2/exceptions/treatment/group/pending HTTP/1.1
Host: <ip>:8085
Content-Type: application/json
Accept: */*
Content-Length: 111
{
"gguid": "text",
"pendingTreatment": "ACCEPT",
"user": "text",
"comments": "text",
"timeout": 1,
"permissions": [
"text"
]
}202
ACCEPTED
{
"status": "OK",
"treatTguid": "text",
"failReason": "text"
}Treats an uncertain biometric candidate that has been locked by the user. The request must include user (overwritten by the security token when API security is enabled), permissions, enrollTguid, exceptionPguid (the matched person), a decision (HIT, NO_HIT or UNCERTAIN_EXPERT), index and a timeout. Returns 202 Accepted with a data.status reflecting the outcome: ON, ENQUEUED or ERROR when all biometric treatments have been processed and the exception is treated as APPROVED; NOT_FINAL when further biometrics remain; BIOGRAPHIC, BIOMETRIC_MISMATCH or BIOMETRIC_INCONCLUSIVE when the treatments result in a biographic, mismatch or inconclusive target.
Body
enrollTguidstringOptional
exceptionPguidstringOptional
indexinteger · int32Optional
decisionstring · enumOptionalPossible values:
userstringOptional
timeoutinteger · int32Optional
permissionsstring[]Optional
Responses
202
ACCEPTED
application/json
post
/exceptions/treatment/biometricPOST /gbds/v2/exceptions/treatment/biometric HTTP/1.1
Host: <ip>:8085
Content-Type: application/json
Accept: */*
Content-Length: 122
{
"enrollTguid": "text",
"exceptionPguid": "text",
"index": 1,
"decision": "HIT",
"user": "text",
"timeout": 1,
"permissions": [
"text"
]
}202
ACCEPTED
{
"status": "OK",
"treatTguid": "text",
"failReason": "text"
}Retrieves the treatment result for a biometric candidate identified by transaction GUID (tguid), person GUID (pguid) and biometric index. Returns 202 Accepted with the same data structure as the biometric treatment response, enabling clients to poll for the final status.
Path parameters
tguidstringRequired
pguidstringRequired
indexinteger · int32Required
Responses
202
ACCEPTED
application/json
get
/exceptions/treatment/biometric/{tguid}/{pguid}/biometric/{index}GET /gbds/v2/exceptions/treatment/biometric/{tguid}/{pguid}/biometric/{index} HTTP/1.1
Host: <ip>:8085
Accept: */*
202
ACCEPTED
{
"status": "OK",
"treatTguid": "text",
"failReason": "text"
}Retrieves the treatment result for a biometric candidate identified by aggregated GUID (aguid) and biometric index. This endpoint is used when dealing with aggregated transaction identifiers. Returns 202 Accepted with the same data structure as the biometric treatment response.
Path parameters
aguidstringRequired
indexinteger · int32Required
Responses
202
ACCEPTED
application/json
get
/exceptions/treatment/biometric/{aguid}/biometric/{index}GET /gbds/v2/exceptions/treatment/biometric/{aguid}/biometric/{index} HTTP/1.1
Host: <ip>:8085
Accept: */*
202
ACCEPTED
{
"status": "OK",
"treatTguid": "text",
"failReason": "text"
}Re-executes the processing of transaction exceptions listed in the request, re-applying extraction/identification steps to correct failures.
Body
tguidsstring[]Optional
pageSizeinteger · int32Optional
userstringOptional
commentsstringOptional
justAnalysebooleanOptional
Responses
200
OK
application/json
put
/exceptions/reprocessPUT /gbds/v2/exceptions/reprocess HTTP/1.1
Host: <ip>:8085
Content-Type: application/json
Accept: */*
Content-Length: 83
{
"tguids": [
"text"
],
"pageSize": 1,
"user": "text",
"comments": "text",
"justAnalyse": true
}200
OK
{
"status": "OK",
"treatTguid": "text",
"failReason": "text"
}Provides the progress and result of reprocessing a specific exception identified by the GUID.
Path parameters
guidstringRequired
Responses
200
OK
application/json
get
/exceptions/reprocess/{guid}GET /gbds/v2/exceptions/reprocess/{guid} HTTP/1.1
Host: <ip>:8085
Accept: */*
200
OK
{
"guid": "text",
"exceptions": [
{
"index": 1,
"aguid": "text",
"entrantTguid": "text",
"entrantPguid": "text",
"entrantReextracted": true,
"referenceTguid": "text",
"referencePguid": "text",
"referenceReextracted": true,
"type": "ENROLL",
"oldStatus": "ANALYSIS",
"newStatus": "ANALYSIS",
"message": "text",
"httpResponse": {
"httpCode": 1,
"body": "text"
}
}
],
"status": "ENQUEUED",
"index": 1,
"processed": 1,
"total": 1,
"httpResponse": {
"httpCode": 1,
"body": "text"
}
}Manually reprocesses a transaction in exception, provided in the body, returning the result of this re-execution.
Body
tguidstringOptional
userstringOptional
commentsstringOptional
justAnalysebooleanOptional
Responses
200
OK
application/json
put
/exceptions/reprocess/onePUT /gbds/v2/exceptions/reprocess/one HTTP/1.1
Host: <ip>:8085
Content-Type: application/json
Accept: */*
Content-Length: 67
{
"tguid": "text",
"user": "text",
"comments": "text",
"justAnalyse": true
}200
OK
{
"guid": "text",
"exceptions": [
{
"index": 1,
"aguid": "text",
"entrantTguid": "text",
"entrantPguid": "text",
"entrantReextracted": true,
"referenceTguid": "text",
"referencePguid": "text",
"referenceReextracted": true,
"type": "ENROLL",
"oldStatus": "ANALYSIS",
"newStatus": "ANALYSIS",
"message": "text",
"httpResponse": {
"httpCode": 1,
"body": "text"
}
}
],
"status": "ENQUEUED",
"index": 1,
"processed": 1,
"total": 1,
"httpResponse": {
"httpCode": 1,
"body": "text"
}
}Selects and locks the next available exception group for analysis and treatment. The request includes a user (overwritten by the security token when API security is on), a list of organization permissions, an optional order (ASC or DESC) controlling the sort by priority, pending status and timestamp, and an origin (ENTRANT or BOTH) to filter by organization origin. Responds with 200 OK when a group is found, returning data with group details and remaining for the count of groups pending analysis or pending treatment. Returns 204 No Content when no group is available.
Body
userstringOptional
orderstring · enumOptionalPossible values:
permissionsstring[]Optional
originstring · enumOptionalPossible values:
pendingbooleanOptional
Responses
200
OK
application/json
post
/exceptions/nextGroupPOST /gbds/v2/exceptions/nextGroup HTTP/1.1
Host: <ip>:8085
Content-Type: application/json
Accept: */*
Content-Length: 86
{
"user": "text",
"order": "ASC",
"permissions": [
"text"
],
"origin": "ENTRANT",
"pending": true
}200
OK
{
"remaining": 1,
"treatable": true,
"httpResponse": {
"httpCode": 1,
"body": "text"
},
"data": {
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": "[Circular Reference]",
"holdingGroups": "[Circular Reference]"
}
],
"holdingGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": "[Circular Reference]",
"holdingGroups": "[Circular Reference]"
}
]
}
],
"holdingGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": "[Circular Reference]",
"holdingGroups": "[Circular Reference]"
}
]
}
}Selects and locks the next uncertain biometric candidate requiring a manual decision. The request includes a user (overwritten by the security token when API security is enabled), a list of permissions, an order (ASC or DESC), an optional modality (FINGERPRINT or FACE) and an origin (ENTRANT or BOTH). If no biometric is available, responds with 204 No Content. Otherwise returns 200 OK with remaining for the number of remaining biometrics and data containing the selected biometric candidate: enrollPguid, enrollTguid, transactionTimestamp, match details (matchedPersonPguid, matchedPersonTguid, biometricMatches with score, queryIndex, referenceIndex, minutia and decision), exceptionAnalysis status (ANALYSIS), transactionType, priority and target.
Body
userstringOptional
orderstring · enumOptionalPossible values:
permissionsstring[]Optional
modalitystring · enumOptionalPossible values:
originstring · enumOptionalPossible values:
Responses
200
OK
application/json
204
NO CONTENT
application/json
post
/exceptions/nextBiometricPOST /gbds/v2/exceptions/nextBiometric HTTP/1.1
Host: <ip>:8085
Content-Type: application/json
Accept: */*
Content-Length: 96
{
"user": "text",
"order": "ASC",
"permissions": [
"text"
],
"modality": "FINGERPRINT",
"origin": "ENTRANT"
}{
"data": {
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
}Retrieves detailed logs of transaction exception handling, allowing auditing by period, pguid, tguid and other parameters.
Query parameters
startDateinteger · int64Optional
endDateinteger · int64Optional
userstringOptional
operationstring · enumOptionalPossible values:
typestring · enumOptionalPossible values:
statusstring · enumOptionalPossible values:
decisionstring · enumOptionalPossible values:
indexinteger · int32Optional
pageIndexinteger · int32Optional
pageSizeinteger · int32Optional
Responses
200
OK
application/json
get
/exceptions/logGET /gbds/v2/exceptions/log HTTP/1.1
Host: <ip>:8085
Accept: */*
200
OK
{
"httpResponse": {
"httpCode": 1,
"body": "text"
},
"data": [
{
"guid": "text",
"logType": "EXCEPTION",
"operation": "UNKNOWN",
"index": 1,
"status": "ANALYSIS",
"decision": "UNCERTAIN",
"user": "text",
"timestamp": "2025-11-03T04:43:04.180Z",
"tguid": "text",
"pguid": "text",
"keptTguids": [
"text"
],
"message": "text"
}
],
"pagination": {
"total": 1,
"count": 1,
"pageSize": 1,
"currentPage": 1,
"totalPages": 1
}
}Returns a paginated list of exception groups pending analysis or treatment. Use query parameters to filter by status, decision, date range, user, lockedUser, priority flag, target, organization, origin (ENTRANT, REFERENCE, BOTH), and pagination (pageIndex, pageSize). Groups are ordered by priority, pending status, target and creation time. Each group entry includes group identifiers (gguid, tguid), target, status, decision, priority flag, organizations with origin, timestamps, user, comments, and decision parameters such as keys, biographics, labels, kept and removed transactions.
Query parameters
startDateinteger · int64Optional
endDateinteger · int64Optional
userstringOptional
lockedUserstringOptional
prioritybooleanOptional
targetstring · enumOptionalPossible values:
organizationstring[]Optional
permissionstring[]Optional
userOrganizationsbooleanOptional
gguidstring[]Optional
keystring[]Optional
pageIndexinteger · int32Optional
pageSizeinteger · int32Optional
Responses
200
OK
application/json
get
/exceptions/groupGET /gbds/v2/exceptions/group HTTP/1.1
Host: <ip>:8085
Accept: */*
200
OK
{
"httpResponse": {
"httpCode": 1,
"body": "text"
},
"data": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": [
"[Circular Reference]"
],
"holdingGroups": [
"[Circular Reference]"
]
}
],
"holdingGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": [
"[Circular Reference]"
],
"holdingGroups": [
"[Circular Reference]"
]
}
],
"holdingGroups": [
"[Circular Reference]"
]
}
]
}
],
"pagination": {
"total": 1,
"count": 1,
"pageSize": 1,
"currentPage": 1,
"totalPages": 1
}
}Retrieves details of an exception group by its GUID (gguid). The response includes the group metadata—gguid, tguid, target, status, decision, priority flag, organizations with origin, created and updated timestamps, user and comments—and the associated exceptions within the group. Each exception entry contains the enrollee identifiers, match details (score and index values), analysis status, transaction type, priority and target.
Path parameters
gguidstringRequired
Query parameters
permissionstring[]Optional
Responses
200
OK
application/json
get
/exceptions/group/{gguid}GET /gbds/v2/exceptions/group/{gguid} HTTP/1.1
Host: <ip>:8085
Accept: */*
200
OK
{
"remaining": 1,
"treatable": true,
"httpResponse": {
"httpCode": 1,
"body": "text"
},
"data": {
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": "[Circular Reference]",
"holdingGroups": "[Circular Reference]"
}
],
"holdingGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": "[Circular Reference]",
"holdingGroups": "[Circular Reference]"
}
]
}
],
"holdingGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": "[Circular Reference]",
"holdingGroups": "[Circular Reference]"
}
]
}
}Locks an unlocked exception group so that the current user can treat it. When API security is enabled, the user is derived from the token; otherwise a user must be provided. Returns 204 No Content upon success.
Path parameters
gguidstringRequired
Responses
204
NO CONTENT
application/json
Responseobject
put
/exceptions/group/{gguid}/userPUT /gbds/v2/exceptions/group/{gguid}/user HTTP/1.1
Host: <ip>:8085
Accept: */*
204
NO CONTENT
{}Unlocks a locked exception group for the current user (derived from the token) or for a provided user when API security is disabled. The group must be locked by that user. Returns 204 No Content.
Path parameters
gguidstringRequired
Responses
204
NO CONTENT
application/json
Responseobject
delete
/exceptions/group/{gguid}/userDELETE /gbds/v2/exceptions/group/{gguid}/user HTTP/1.1
Host: <ip>:8085
Accept: */*
204
NO CONTENT
{}Locks an unlocked exception group for the specified user. This operation is used when API security is disabled and authentication through tokens is unavailable. Returns 204 No Content.
Path parameters
gguidstringRequired
userstringRequired
Responses
204
NO CONTENT
application/json
Responseobject
put
/exceptions/group/{gguid}/user/{user}PUT /gbds/v2/exceptions/group/{gguid}/user/{user} HTTP/1.1
Host: <ip>:8085
Accept: */*
204
NO CONTENT
{}Unlocks a previously locked exception group for a specified user. The group must be locked by the same user. Returns 204 No Content.
Path parameters
gguidstringRequired
userstringRequired
Responses
204
NO CONTENT
application/json
Responseobject
delete
/exceptions/group/{gguid}/user/{user}DELETE /gbds/v2/exceptions/group/{gguid}/user/{user} HTTP/1.1
Host: <ip>:8085
Accept: */*
204
NO CONTENT
{}Updates the refused status of an exception group. The status may be one of CREATED, REMOVED, READY_TO_RESEND, SENDING, SENT or ERROR. This endpoint sets the refused_status field for the group and returns 204 No Content.
Path parameters
gguidstringRequired
statusstring · enumRequiredPossible values:
Query parameters
permissionstring[]Optional
Responses
204
NO CONTENT
application/json
Responseobject
put
/exceptions/group/{gguid}/refused/{status}PUT /gbds/v2/exceptions/group/{gguid}/refused/{status} HTTP/1.1
Host: <ip>:8085
Accept: */*
204
NO CONTENT
{}Sets or clears the priority flag on an exception group. When priority is true, the group and its contained exceptions are prioritized; when false, the priority is removed. Returns 204 No Content.
Path parameters
gguidstringRequired
prioritybooleanRequired
Responses
204
NO CONTENT
application/json
Responseobject
put
/exceptions/group/{gguid}/priority/{priority}PUT /gbds/v2/exceptions/group/{gguid}/priority/{priority} HTTP/1.1
Host: <ip>:8085
Accept: */*
204
NO CONTENT
{}Retrieves the exception group associated with the specified transaction GUID (tguid). The returned structure is the same as retrieving a group by gguid.
Path parameters
tguidstringRequired
Query parameters
permissionstring[]Optional
Responses
200
OK
application/json
get
/exceptions/group/tguid/{tguid}GET /gbds/v2/exceptions/group/tguid/{tguid} HTTP/1.1
Host: <ip>:8085
Accept: */*
200
OK
{
"remaining": 1,
"treatable": true,
"httpResponse": {
"httpCode": 1,
"body": "text"
},
"data": {
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": "[Circular Reference]",
"holdingGroups": "[Circular Reference]"
}
],
"holdingGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": "[Circular Reference]",
"holdingGroups": "[Circular Reference]"
}
]
}
],
"holdingGroups": [
{
"gguid": "text",
"tguid": "text",
"target": "BIOGRAPHIC",
"decision": "APPROVE",
"status": "ANALYSIS",
"priority": true,
"organizations": [
{
"parent": "text",
"name": "text",
"description": "text"
}
],
"created": "2025-11-03T04:43:04.180Z",
"updated": "2025-11-03T04:43:04.180Z",
"user": "text",
"comments": "text",
"message": "text",
"parameters": {
"keys": [
{
"id": "text",
"value": "text"
}
],
"biographics": [
{
"id": "text",
"value": "text"
}
],
"labels": [
"text"
],
"keepTransactions": [
"text"
],
"removeTransactions": [
"text"
]
},
"lightsOutCriteria": {
"nonConflitantKeys": [
{
"id": "text",
"value": "text"
}
],
"weakKeys": [
"text"
],
"matchedBiographics": [
"text"
]
},
"lockedUser": "text",
"lockedTimestamp": "2025-11-03T04:43:04.180Z",
"lockedTimeout": "2025-11-03T04:43:04.180Z",
"exceptions": [
{
"enrollPguid": "text",
"enrollTguid": "text",
"transactionTimestamp": 1,
"match": {
"matchedPersonPguid": "text",
"matchedPersonTguid": "text",
"biometricMatches": [
{
"score": 1,
"queryIndex": 1,
"referenceIndex": 1,
"minutia": [
{
"query": 1,
"reference": 1
}
]
}
]
},
"assignedUser": "text",
"exceptionAnalysis": {
"status": "ANALYSIS",
"exceptionTimestamp": 1,
"user": "text",
"comments": "text"
},
"transactionType": "ENROLL"
}
],
"newTguid": "text",
"refusedStatus": "CREATED",
"refusedNewTguid": "text",
"refusedGroups": "[Circular Reference]",
"holdingGroups": "[Circular Reference]"
}
]
}
}Counts the number of exception groups remaining for analysis or treatment and the number of group treatments performed by the user on the current day. The request body includes user (overwritten by the security token when API security is enabled), a list of permissions and an optional origin (ENTRANT or BOTH). The response returns remaining and doneByTheDay maps keyed by status.
Body
userstringOptional
permissionsstring[]Optional
originstring · enumOptionalPossible values:
Responses
200
OK
application/json
post
/exceptions/countGroupsPOST /gbds/v2/exceptions/countGroups HTTP/1.1
Host: <ip>:8085
Content-Type: application/json
Accept: */*
Content-Length: 57
{
"user": "text",
"permissions": [
"text"
],
"origin": "ENTRANT"
}200
OK
{
"remaining": {
"ANY_ADDITIONAL_PROPERTY": 1
},
"doneByTheDay": {
"ANY_ADDITIONAL_PROPERTY": 1
},
"httpResponse": {
"httpCode": 1,
"body": "text"
}
}Counts the number of remaining uncertain biometrics requiring treatment and the number of decisions made by the user on the current day. The request includes user (overwritten by the security token when API security is enabled), a list of permissions and an optional origin (ENTRANT or BOTH). The response returns remaining and doneByTheDay maps keyed by modality (FINGERPRINT and FACE).
Body
userstringOptional
permissionsstring[]Optional
Responses
200
OK
application/json
post
/exceptions/countBiometricPOST /gbds/v2/exceptions/countBiometric HTTP/1.1
Host: <ip>:8085
Content-Type: application/json
Accept: */*
Content-Length: 38
{
"user": "text",
"permissions": [
"text"
]
}200
OK
{
"remaining": {
"ANY_ADDITIONAL_PROPERTY": 1
},
"doneByTheDay": {
"ANY_ADDITIONAL_PROPERTY": 1
},
"httpResponse": {
"httpCode": 1,
"body": "text"
}
}Was this helpful?