action frankiefinancial_search_entity {
  label: "Search for Entity"
  description: "\nSearch for an existing entity that matches the criteria supplied\n\nCriteria are supplied in the form of a populated entity object, with the name/address/DoB details supplied.\nYou can also include documents that can be used to further refine your search (see the /document/search function for minimum requirements for a document search)\n\nAt an absolute minimum, you must supply one of the following combinations:\n\n  * name.familyName +\n  * name.givenNames\n  \n  or\n  \n  * name.familyName +\n  * one identityDocument object (that meets minimum criteria)\n  \nObviously, the more data you provide, the better search results we can provide.\n\nThe service will return a list of matching entities with confidence levels.\n\nIf you are the \"owner\" of the entity - i.e. the same CustomerID and CustomerChildID (if relevant) - then the full details of the entity and any owned documents will be returned, except for the contents of any attached scans.\n\nIf you are not the owner of the entity (or linked documents), then just the ID and confidence level is returned. You can still use this ID to retrieve any check results (see GET  /entity/{entityId}/checks and GET /document/{documentId}/checks)\n\nNote: This functionality must be enabled by Frankie administrators. Please contact your sales representative if you wish to discuss this.\n"
  provider: frankiefinancial
  method: POST
  path: "/entity/search"
  encoding: json
  output: {
    type: "object"
    additionalProperties: true
  }
}