Every API here is available over the APIs.io API and to AI agents over MCP.
{
"openapi": "3.0.1",
"info": {
"title": "Fenergo Nebula Screening Query",
"description": "**Screening Query API**:\n\n<br> Screening Query API retrieves screening results for screened clients and their associated parties. Use Screening Command API to perform the screening action and Screening Query API to retrieve screening results.\n\n<br> **Screening Query API Provides**:\n\n<br><ul><li> The ability to retrieve screening results for all entities within a given batch of Legal Entities. batchID + tenant can be used to retrieve screening results of all entities within a given batch.<li> The ability to retrieve batch data for a batch of Legal Entities. BatchID + tenant **OR** journeyID + tenant can be used to retrieve results for a batch of screened Legal Entities.<li> The ability to retrieve screening results for a single entity within a given batch of Legal Entities. EntityID + batchID + tenant can be used to retrieve screening results for a given entity.<li> The ability to retrieve screening results for all matches of a given entity. EntityID + batchID + tenant can be used to retrieve screening results that match the given entity.<li> The ability to retrieve screening results for matches of a given match ID. EntityID + batchID + matchID + tenant can be used to retrieve screening results that match the given match ID.",
"version": "2.0"
},
"servers": [
{
"url": "/screeningquery"
}
],
"paths": {
"/api/v2/batch/{id}": {
"get": {
"tags": [
"Batch"
],
"summary": "Get data of an existing batch with batch Id",
"description": "\nThis method gets all the batch data for a given batch Id and tenant Id.\r\n\nThe method returns the batch object.<br /><br /><b>Required permissions:</b><br />Following permissions are required: ScreeningAccess",
"operationId": "GetBatchById",
"parameters": [
{
"name": "id",
"in": "path",
"description": "The Id of the existing batch to get",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Success. The batch data is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BatchDtoServiceResponse"
}
}
}
},
"400": {
"description": "Bad request. The request has missing/invalid values",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Not found. The batch couldn't be found",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server error"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/v2/batch/journey/{journeyId}": {
"get": {
"tags": [
"Batch"
],
"summary": "Get data of an existing batch with journey Id",
"description": "\nThis method gets all the batch data linked to a journey Id and tenant Id.\r\n\nThe method returns the batch object.<br /><br /><b>Required permissions:</b><br />Following permissions are required: ScreeningAccess",
"operationId": "GetBatchByJourneyId",
"parameters": [
{
"name": "journeyId",
"in": "path",
"description": "The Id of the journey",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Success. The batch data is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BatchDtoServiceResponse"
}
}
}
},
"400": {
"description": "Bad request. The request has missing/invalid values",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Not found. The batch couldn't be found",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server error"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/v2/batch/journey/{journeyId}/process/{processId}": {
"get": {
"tags": [
"Batch"
],
"summary": "Get data of an existing batch with journey Id and process Id",
"description": "\nThis method gets all the batch data linked to a journey Id, process Id and tenant Id.\r\n\nThe method returns the batch object.<br /><br /><b>Required permissions:</b><br />Following permissions are required: ScreeningAccess",
"operationId": "GetBatchByJourneyAndProcessId",
"parameters": [
{
"name": "journeyId",
"in": "path",
"description": "The Id of the journey",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "processId",
"in": "path",
"description": "The Id of the process that started the batch",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Success. The batch data is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BatchDtoServiceResponse"
}
}
}
},
"400": {
"description": "Bad request. The request has missing/invalid values",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Not found. The batch couldn't be found",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server error"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/v2/batch/legalentity/{legalEntityId}": {
"get": {
"tags": [
"Batch"
],
"summary": "Get the batches with Legal Entity Id",
"description": "\nThis method gets all the batches linked to a Legal Entity Id and Tenant Id.\r\n\nThe method returns the batch array.<br /><br /><b>Required permissions:</b><br />Following permissions are required: ScreeningAccess",
"operationId": "GetBatchesByLegalEntityId",
"parameters": [
{
"name": "legalEntityId",
"in": "path",
"description": "The Id of the Legal Entity",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "onlyWithTrueMatches",
"in": "query",
"description": "Flag to return only the batches with true matches",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Success. The batches are returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LegalEntityBatchDtoIEnumerableServiceResponse"
}
}
}
},
"400": {
"description": "Bad request. The request has missing/invalid values",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Not found. The Legal Entity couldn't be found",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server error"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/v2/batch/{batchId}/entity": {
"get": {
"tags": [
"Entity"
],
"summary": "Get all entities in a batch",
"description": "\nThis method returns all entities for a given batch ID and tenant ID, without including the matches of each entity.\r\n\nThe method returns a list of entity objects.<br /><br /><b>Required permissions:</b><br />Following permissions are required: ScreeningAccess",
"operationId": "GetEntitiesByBatchIdV2",
"parameters": [
{
"name": "batchId",
"in": "path",
"description": "The ID of the batch the entities belong to",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Success. The list of entities is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BatchEntityDtoV2IEnumerableServiceResponse"
}
}
}
},
"400": {
"description": "Bad request. The request has missing/invalid values",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Not Found",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server error"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/v2/batch/{batchId}/entity/{entityId}": {
"get": {
"tags": [
"Entity"
],
"summary": "Get data of an entity",
"description": "\nThis method returns the entity data for a given entity ID, batch ID and tenant ID, without including the matches of the entity.\r\n\nThe method will return the entity object.<br /><br /><b>Required permissions:</b><br />Following permissions are required: ScreeningAccess",
"operationId": "GetEntityByIdV2",
"parameters": [
{
"name": "entityId",
"in": "path",
"description": "The ID of the entity",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "batchId",
"in": "path",
"description": "The batch ID the entity belongs to",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Success. The entity data is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BatchEntityDtoV2ServiceResponse"
}
}
}
},
"400": {
"description": "Bad request. The request has missing/invalid values",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Not found. The entity could not be found",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server error"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/v2/batch/{batchId}/entity/{entityId}/match": {
"get": {
"tags": [
"Match"
],
"summary": "Get all matches for an entity",
"description": "\nThis method returns all matches for a given entity ID, batch ID and tenant ID.\r\n\nThe method will return a list of match objects.<br /><br /><b>Required permissions:</b><br />Following permissions are required: ScreeningAccess",
"operationId": "GetMatchesByEntityId",
"parameters": [
{
"name": "entityId",
"in": "path",
"description": "The ID of the entity the matches belong to",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "batchId",
"in": "path",
"description": "The batch ID the entity belongs to",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "returnMaterialMatches",
"in": "query",
"description": "Return only matches with status Match",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Success. The list of matches is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MatchDtoIEnumerableServiceResponse"
}
}
}
},
"400": {
"description": "Bad request. The request has missing/invalid values",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Not Found",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server error"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceR
# --- truncated at 32 KB (135 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/fenergo/refs/heads/main/openapi/fenergo-screeningquery-v2-0-openapi.json