Skip to main content
POST
/
v2
/
organizations
/
{entityId}
Organization Update
curl --request POST \
  --url https://api.frankie.one/v2/organizations/{entityId} \
  --header 'Content-Type: application/json' \
  --header 'X-Frankie-CustomerID: <x-frankie-customerid>' \
  --header 'api_key: <api-key>' \
  --data '
{
  "externalReferences": [
    {
      "name": "CUSTOMER-REFERENCE",
      "value": "CUST-00001342",
      "description": "This is the customer ID in the core banking system.",
      "referenceId": "<string>"
    }
  ]
}
'
{
  "requestId": "01HN9XHZN6MGXM9JXG50K59Q85",
  "organization": {
    "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "entityType": "INDIVIDUAL",
    "createdAt": "2023-11-07T05:31:56Z",
    "schemaVersion": 2,
    "addresses": [
      {
        "country": "<string>",
        "addressId": "<string>",
        "sourceId": "<string>",
        "type": "OTHER",
        "typeDescription": "<string>",
        "validFrom": {
          "year": "1990",
          "month": "03",
          "day": "27",
          "unstructured": "12 Rajab 1445 AH",
          "type": "GREGORIAN",
          "normalized": "1990-03-31"
        },
        "validTo": {
          "year": "1990",
          "month": "03",
          "day": "27",
          "unstructured": "12 Rajab 1445 AH",
          "type": "GREGORIAN",
          "normalized": "1990-03-31"
        },
        "longForm": "<string>",
        "unitNumber": "<string>",
        "buildingName": "<string>",
        "streetName": "<string>",
        "streetNumber": "<string>",
        "streetType": "<string>",
        "neighborhood": "<string>",
        "locality": "<string>",
        "district": "<string>",
        "subdivision": "<string>",
        "postalCode": "<string>",
        "careOf": "<string>",
        "status": "CURRENT",
        "unstructuredLongForm": "<string>"
      }
    ],
    "phoneNumbers": [
      {
        "phoneNumberId": "ad165f64-5717-4562-b3fc-2c963f66bfa9",
        "isPreferred": true,
        "type": "MOBILE",
        "sourceId": "14fd5f64-5717-4562-b3fc-2c963f66ba34",
        "country": "AUS",
        "number": "0426192340",
        "linkedAddresses": [
          {
            "addressId": "fa335f64-5717-4562-b3fc-2c963f66cf41"
          }
        ],
        "unstructuredLongForm": "<string>"
      }
    ],
    "emailAddresses": [
      {
        "emailAddressId": "aa385f64-5717-4562-b3fc-2c963f66af21",
        "type": "WORK",
        "sourceId": "31dd15f64-5717-4562-b3fc-2c963f66234d",
        "email": "[email protected]",
        "isPreferred": true,
        "linkedAddresses": [
          {
            "addressId": "adc215f64-5717-4562-b3fc-2c963f66222a"
          }
        ]
      }
    ],
    "customAttributes": {},
    "externalReferences": [
      {
        "name": "CUSTOMER-REFERENCE",
        "value": "CUST-00001342",
        "referenceId": "24de15f64-5717-4562-b3fc-2c963f66e23e",
        "type": "CUSTOMER",
        "sourceId": "93da15f64-5717-4562-b3fc-2c963f6663fe",
        "description": "This is the customer ID in the core banking system."
      }
    ],
    "documents": {
      "REPORT": [
        {
          "type": "OTHER",
          "country": "AUS",
          "documentId": "92de15f64-5717-4562-b3fc-2c963f6665a7",
          "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "expiryDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "issueDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "primaryIdentifier": "000734130",
          "secondaryIdentifier": "P0001975",
          "subtype": "Photo Comparison",
          "subdivision": "VIC",
          "createdAt": "2024-01-15T02:18:11.365Z",
          "updatedAt": "2025-01-16T02:18:11.365Z",
          "validFrom": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "validTo": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "sourceId": "324f15f64-5717-4562-b3fc-2c963f66ffa1",
          "supplementaryData": {
            "type": "NATIONAL_HEALTH_ID",
            "reference": "1",
            "nameOnCardLine1": "<string>",
            "nameOnCardLine2": "<string>",
            "nameOnCardLine3": "<string>",
            "nameOnCardLine4": "<string>",
            "middleNameOnCard": "<string>"
          },
          "customAttributes": {},
          "attachments": [
            {
              "data": {
                "uri": "https://s3.amazonaws.com/dev/41963bc5feff322020137de233c3be0fac6/croppedFrontID/38d54232-b840-431d-b248-152345fe214.jpg"
              },
              "attachmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "sourceId": "<string>",
              "createdAt": "2023-11-07T05:31:56Z",
              "updatedAt": "2023-11-07T05:31:56Z",
              "filename": "<string>",
              "mimeType": "<string>",
              "pageNumber": 123,
              "side": "FRONT",
              "type": "<string>",
              "location": "<string>",
              "lastMalwareScanAt": "2023-11-07T05:31:56Z",
              "retrievalStatus": "NORMAL"
            }
          ]
        }
      ],
      "SUPPORTING": [
        {
          "type": "OTHER",
          "country": "AUS",
          "documentId": "92de15f64-5717-4562-b3fc-2c963f6665a7",
          "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "expiryDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "issueDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "primaryIdentifier": "000734130",
          "secondaryIdentifier": "P0001975",
          "subtype": "Photo Comparison",
          "subdivision": "VIC",
          "createdAt": "2024-01-15T02:18:11.365Z",
          "updatedAt": "2025-01-16T02:18:11.365Z",
          "validFrom": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "validTo": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "sourceId": "324f15f64-5717-4562-b3fc-2c963f66ffa1",
          "supplementaryData": {
            "type": "NATIONAL_HEALTH_ID",
            "reference": "1",
            "nameOnCardLine1": "<string>",
            "nameOnCardLine2": "<string>",
            "nameOnCardLine3": "<string>",
            "nameOnCardLine4": "<string>",
            "middleNameOnCard": "<string>"
          },
          "customAttributes": {},
          "attachments": [
            {
              "data": {
                "uri": "https://s3.amazonaws.com/dev/41963bc5feff322020137de233c3be0fac6/croppedFrontID/38d54232-b840-431d-b248-152345fe214.jpg"
              },
              "attachmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "sourceId": "<string>",
              "createdAt": "2023-11-07T05:31:56Z",
              "updatedAt": "2023-11-07T05:31:56Z",
              "filename": "<string>",
              "mimeType": "<string>",
              "pageNumber": 123,
              "side": "FRONT",
              "type": "<string>",
              "location": "<string>",
              "lastMalwareScanAt": "2023-11-07T05:31:56Z",
              "retrievalStatus": "NORMAL"
            }
          ]
        }
      ],
      "IDENTITY": [
        {
          "type": "OTHER",
          "country": "AUS",
          "documentId": "92de15f64-5717-4562-b3fc-2c963f6665a7",
          "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "expiryDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "issueDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "primaryIdentifier": "000734130",
          "secondaryIdentifier": "P0001975",
          "subtype": "Photo Comparison",
          "subdivision": "VIC",
          "createdAt": "2024-01-15T02:18:11.365Z",
          "updatedAt": "2025-01-16T02:18:11.365Z",
          "validFrom": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "validTo": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "sourceId": "324f15f64-5717-4562-b3fc-2c963f66ffa1",
          "supplementaryData": {
            "type": "NATIONAL_HEALTH_ID",
            "reference": "1",
            "nameOnCardLine1": "<string>",
            "nameOnCardLine2": "<string>",
            "nameOnCardLine3": "<string>",
            "nameOnCardLine4": "<string>",
            "middleNameOnCard": "<string>"
          },
          "customAttributes": {},
          "attachments": [
            {
              "data": {
                "uri": "https://s3.amazonaws.com/dev/41963bc5feff322020137de233c3be0fac6/croppedFrontID/38d54232-b840-431d-b248-152345fe214.jpg"
              },
              "attachmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "sourceId": "<string>",
              "createdAt": "2023-11-07T05:31:56Z",
              "updatedAt": "2023-11-07T05:31:56Z",
              "filename": "<string>",
              "mimeType": "<string>",
              "pageNumber": 123,
              "side": "FRONT",
              "type": "<string>",
              "location": "<string>",
              "lastMalwareScanAt": "2023-11-07T05:31:56Z",
              "retrievalStatus": "NORMAL"
            }
          ]
        }
      ],
      "OTHER": [
        {
          "type": "OTHER",
          "country": "AUS",
          "documentId": "92de15f64-5717-4562-b3fc-2c963f6665a7",
          "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "expiryDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "issueDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "primaryIdentifier": "000734130",
          "secondaryIdentifier": "P0001975",
          "subtype": "Photo Comparison",
          "subdivision": "VIC",
          "createdAt": "2024-01-15T02:18:11.365Z",
          "updatedAt": "2025-01-16T02:18:11.365Z",
          "validFrom": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "validTo": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "sourceId": "324f15f64-5717-4562-b3fc-2c963f66ffa1",
          "supplementaryData": {
            "type": "NATIONAL_HEALTH_ID",
            "reference": "1",
            "nameOnCardLine1": "<string>",
            "nameOnCardLine2": "<string>",
            "nameOnCardLine3": "<string>",
            "nameOnCardLine4": "<string>",
            "middleNameOnCard": "<string>"
          },
          "customAttributes": {},
          "attachments": [
            {
              "data": {
                "uri": "https://s3.amazonaws.com/dev/41963bc5feff322020137de233c3be0fac6/croppedFrontID/38d54232-b840-431d-b248-152345fe214.jpg"
              },
              "attachmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "sourceId": "<string>",
              "createdAt": "2023-11-07T05:31:56Z",
              "updatedAt": "2023-11-07T05:31:56Z",
              "filename": "<string>",
              "mimeType": "<string>",
              "pageNumber": 123,
              "side": "FRONT",
              "type": "<string>",
              "location": "<string>",
              "lastMalwareScanAt": "2023-11-07T05:31:56Z",
              "retrievalStatus": "NORMAL"
            }
          ]
        }
      ]
    },
    "sourceId": "<string>",
    "websiteUrls": [
      {
        "websiteUrl": "<string>",
        "sourceId": "<string>"
      }
    ],
    "details": {
      "type": {
        "code": "<string>",
        "description": "<string>"
      },
      "class": {
        "code": "<string>",
        "description": "<string>"
      },
      "subClass": {
        "code": "<string>",
        "description": "<string>"
      },
      "subType": {
        "code": "<string>",
        "description": "<string>"
      },
      "registrationDetails": [
        {
          "registrationNumber": "<string>",
          "registry": "<string>",
          "registryDescription": "<string>",
          "isCurrent": true,
          "registeredName": "<string>",
          "registeredNameDetails": {
            "validFrom": {
              "year": "1990",
              "month": "03",
              "day": "27",
              "unstructured": "12 Rajab 1445 AH",
              "type": "GREGORIAN",
              "normalized": "1990-03-31"
            },
            "validTo": {
              "year": "1990",
              "month": "03",
              "day": "27",
              "unstructured": "12 Rajab 1445 AH",
              "type": "GREGORIAN",
              "normalized": "1990-03-31"
            }
          },
          "registeredDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "extractedDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "registeredSubdivision": "<string>",
          "registeredCountry": "<string>",
          "registrationStatus": {
            "normalized": {
              "code": "<string>",
              "description": "<string>"
            },
            "unstructured": {
              "code": "<string>",
              "description": "<string>"
            }
          },
          "registrationNumberType": "<string>",
          "registrationNumberDescription": "<string>",
          "updatedDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "reviewDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "foundationDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "isSuppressed": true,
          "validFrom": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "validTo": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          }
        }
      ],
      "alternateNames": [
        {
          "name": "<string>",
          "type": "<string>",
          "validFrom": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "validTo": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "sourceId": "<string>"
        }
      ],
      "name": {
        "name": "<string>",
        "type": "<string>",
        "validFrom": {
          "year": "1990",
          "month": "03",
          "day": "27",
          "unstructured": "12 Rajab 1445 AH",
          "type": "GREGORIAN",
          "normalized": "1990-03-31"
        },
        "validTo": {
          "year": "1990",
          "month": "03",
          "day": "27",
          "unstructured": "12 Rajab 1445 AH",
          "type": "GREGORIAN",
          "normalized": "1990-03-31"
        },
        "sourceId": "<string>"
      },
      "status": {
        "normalized": {
          "code": "<string>",
          "description": "<string>"
        },
        "unstructured": {
          "code": "<string>",
          "description": "<string>"
        }
      },
      "jurisdiction": {
        "country": "<string>",
        "registry": "<string>",
        "registryDescription": "<string>",
        "subdivision": "<string>"
      },
      "industryDeclarations": [
        {
          "code": "<string>",
          "description": "<string>",
          "language": "<string>"
        }
      ],
      "industryCodes": [
        {
          "code": "<string>",
          "description": "<string>"
        }
      ]
    },
    "shareholders": [
      {
        "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "entityType": "INDIVIDUAL",
        "shareholderType": "<string>",
        "totalShares": 123,
        "totalPercentage": 123,
        "shareholdings": [
          {
            "class": "<string>",
            "classDescription": "<string>",
            "shares": 123,
            "nominalValue": "<string>",
            "isFullyPaid": true,
            "amountPaid": 123,
            "amountDue": 123,
            "amount": 123,
            "unstructuredAmount": "<string>",
            "currency": "<string>",
            "sourceId": "<string>",
            "type": "<string>",
            "status": {
              "normalized": {
                "code": "<string>",
                "description": "<string>"
              },
              "unstructured": {
                "code": "<string>",
                "description": "<string>"
              }
            },
            "percentage": 123,
            "isNonBeneficiallyHeld": true,
            "isJointlyHeld": true
          }
        ]
      }
    ],
    "shareInterests": [
      {
        "class": "<string>",
        "classDescription": "<string>",
        "shares": 123,
        "nominalValue": "<string>",
        "isFullyPaid": true,
        "amountPaid": 123,
        "amountDue": 123,
        "amount": 123,
        "unstructuredAmount": "<string>",
        "currency": "<string>",
        "sourceId": "<string>",
        "type": "<string>",
        "status": {
          "normalized": {
            "code": "<string>",
            "description": "<string>"
          },
          "unstructured": {
            "code": "<string>",
            "description": "<string>"
          }
        },
        "percentage": 123,
        "isBeneficiallyHeld": true,
        "isJointlyHeld": true,
        "members": [
          {
            "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "entityType": "INDIVIDUAL"
          }
        ]
      }
    ],
    "officials": [
      {
        "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "entityType": "INDIVIDUAL",
        "role": {
          "code": "<string>",
          "description": "<string>"
        },
        "identification": [
          {
            "type": "DIRECTOR_IDENTIFICATION_NUMBER",
            "idNumber": "<string>",
            "jurisdiction": {
              "country": "<string>",
              "registry": "<string>",
              "registryDescription": "<string>",
              "subdivision": "<string>"
            }
          }
        ],
        "sourceId": "<string>",
        "appointmentDate": {
          "year": "1990",
          "month": "03",
          "day": "27",
          "unstructured": "12 Rajab 1445 AH",
          "type": "GREGORIAN",
          "normalized": "1990-03-31"
        },
        "cessationDate": {
          "year": "1990",
          "month": "03",
          "day": "27",
          "unstructured": "12 Rajab 1445 AH",
          "type": "GREGORIAN",
          "normalized": "1990-03-31"
        },
        "status": {
          "normalized": {
            "code": "<string>",
            "description": "<string>"
          },
          "unstructured": {
            "code": "<string>",
            "description": "<string>"
          }
        },
        "directorships": [
          {
            "organization": {
              "organizationName": "<string>",
              "registrationNumber": "<string>",
              "organizationStatus": {
                "normalized": {
                  "code": "<string>",
                  "description": "<string>"
                },
                "unstructured": {
                  "code": "<string>",
                  "description": "<string>"
                }
              }
            },
            "role": {
              "code": "<string>",
              "description": "<string>"
            },
            "sourceId": "<string>",
            "appointmentDate": {
              "year": "1990",
              "month": "03",
              "day": "27",
              "unstructured": "12 Rajab 1445 AH",
              "type": "GREGORIAN",
              "normalized": "1990-03-31"
            },
            "nationality": "<string>"
          }
        ]
      }
    ],
    "shareCapital": {
      "totalShareCount": 123,
      "shareStructure": [
        {
          "class": "<string>",
          "classDescription": "<string>",
          "shares": 123,
          "nominalValue": "<string>",
          "isFullyPaid": true,
          "amountPaid": 123,
          "amountDue": 123,
          "amount": 123,
          "unstructuredAmount": "<string>",
          "currency": "<string>",
          "sourceId": "<string>",
          "type": "<string>",
          "status": {
            "normalized": {
              "code": "<string>",
              "description": "<string>"
            },
            "unstructured": {
              "code": "<string>",
              "description": "<string>"
            }
          }
        }
      ]
    },
    "indicators": [
      {
        "flag": "<string>",
        "value": 123
      }
    ],
    "jurisdictionalInformation": {
      "personsOfSignificantControl": [
        {
          "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "entityType": "INDIVIDUAL",
          "kind": "<string>",
          "natureOfControl": [
            "<string>"
          ],
          "notifiedOn": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "ceasedOn": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "countryOfResidence": "<string>"
        }
      ],
      "registryInformation": {
        "abnReplacedFrom": {
          "year": "1990",
          "month": "03",
          "day": "27",
          "unstructured": "12 Rajab 1445 AH",
          "type": "GREGORIAN",
          "normalized": "1990-03-31"
        },
        "charityInformation": [
          {
            "type": "<string>",
            "name": "<string>",
            "validFrom": {
              "year": "1990",
              "month": "03",
              "day": "27",
              "unstructured": "12 Rajab 1445 AH",
              "type": "GREGORIAN",
              "normalized": "1990-03-31"
            },
            "validTo": {
              "year": "1990",
              "month": "03",
              "day": "27",
              "unstructured": "12 Rajab 1445 AH",
              "type": "GREGORIAN",
              "normalized": "1990-03-31"
            }
          }
        ],
        "gst": [
          {
            "type": "<string>",
            "name": "<string>",
            "validFrom": {
              "year": "1990",
              "month": "03",
              "day": "27",
              "unstructured": "12 Rajab 1445 AH",
              "type": "GREGORIAN",
              "normalized": "1990-03-31"
            },
            "validTo": {
              "year": "1990",
              "month": "03",
              "day": "27",
              "unstructured": "12 Rajab 1445 AH",
              "type": "GREGORIAN",
              "normalized": "1990-03-31"
            }
          }
        ],
        "superannuationStatus": {
          "complyingCode": "<string>",
          "complyingDescription": "<string>",
          "regulator": "<string>",
          "exceptionMessage": "<string>"
        },
        "acncRegistrations": [
          {
            "status": "<string>",
            "validFrom": {
              "year": "1990",
              "month": "03",
              "day": "27",
              "unstructured": "12 Rajab 1445 AH",
              "type": "GREGORIAN",
              "normalized": "1990-03-31"
            },
            "validTo": {
              "year": "1990",
              "month": "03",
              "day": "27",
              "unstructured": "12 Rajab 1445 AH",
              "type": "GREGORIAN",
              "normalized": "1990-03-31"
            }
          }
        ],
        "dgr": [
          {
            "dgrEntityEndorsement": "<string>",
            "dgrItemNumber": "<string>"
          }
        ],
        "disclosingEntity": true
      },
      "aliases": [
        "<string>"
      ],
      "agents": [
        {
          "name": "<string>",
          "addresses": [
            {
              "country": "<string>",
              "addressId": "<string>",
              "sourceId": "<string>",
              "type": "OTHER",
              "typeDescription": "<string>",
              "validFrom": {
                "year": "1990",
                "month": "03",
                "day": "27",
                "unstructured": "12 Rajab 1445 AH",
                "type": "GREGORIAN",
                "normalized": "1990-03-31"
              },
              "validTo": {
                "year": "1990",
                "month": "03",
                "day": "27",
                "unstructured": "12 Rajab 1445 AH",
                "type": "GREGORIAN",
                "normalized": "1990-03-31"
              },
              "longForm": "<string>",
              "unitNumber": "<string>",
              "buildingName": "<string>",
              "streetName": "<string>",
              "streetNumber": "<string>",
              "streetType": "<string>",
              "neighborhood": "<string>",
              "locality": "<string>",
              "district": "<string>",
              "subdivision": "<string>",
              "postalCode": "<string>",
              "careOf": "<string>",
              "status": "CURRENT",
              "unstructuredLongForm": "<string>"
            }
          ]
        }
      ],
      "vatNumber": "<string>",
      "virtualId": "<string>",
      "officers": [
        {
          "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "entityType": "INDIVIDUAL",
          "title": "<string>",
          "assignedDate": {
            "year": "1990",
            "month": "03",
            "day": "27",
            "unstructured": "12 Rajab 1445 AH",
            "type": "GREGORIAN",
            "normalized": "1990-03-31"
          },
          "type": "<string>"
        }
      ],
      "fiscalCode": {
        "code": "<string>",
        "description": "<string>"
      },
      "legalFormDetails": {
        "basis": "<string>",
        "capital": "<string>",
        "comments": "<string>",
        "control": "<string>",
        "incorp": "<string>",
        "partner": "<string>",
        "responsibility": "<string>",
        "stocks": "<string>"
      },
      "annualAccount": {
        "lastAnnualAccountDate": {
          "year": "1990",
          "month": "03",
          "day": "27",
          "unstructured": "12 Rajab 1445 AH",
          "type": "GREGORIAN",
          "normalized": "1990-03-31"
        }
      }
    },
    "updatedAt": "2023-11-07T05:31:56Z",
    "linkedIndividuals": {},
    "linkedOrganizations": {},
    "linkedUnknownEntities": {},
    "blockingEntities": {},
    "ultimateBeneficialOwners": [
      {
        "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "entityType": "INDIVIDUAL",
        "percentageOwned": {
          "total": 123,
          "isTotalNearZero": true,
          "beneficially": 123,
          "isBeneficialNearZero": true,
          "nonBeneficially": 123,
          "isNonBeneficialNearZero": true,
          "isContainingJointOwnership": true
        },
        "reasons": [
          {
            "code": "<string>",
            "description": "<string>"
          }
        ],
        "sourceId": "<string>"
      }
    ],
    "otherOwners": [
      {
        "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "entityType": "INDIVIDUAL",
        "percentageOwned": {
          "total": 123,
          "isTotalNearZero": true,
          "beneficially": 123,
          "isBeneficialNearZero": true,
          "nonBeneficially": 123,
          "isNonBeneficialNearZero": true,
          "isContainingJointOwnership": true
        },
        "sourceId": "<string>"
      }
    ],
    "informationSources": {},
    "ownershipPolicy": {
      "uboThreshold": 123,
      "blockingThreshold": 123,
      "blockingDefinitions": [
        "ORGANIZATION_NOT_FOUND"
      ]
    }
  }
}

Authorizations

​
api_key
string
header
required

Headers

​
api_key
string
required

Your API key provided by FrankieOne

Example:

"245c765b124a098d09ef8765...."

​
X-Frankie-CustomerID
string
required

Your Customer ID provided by FrankieOne

Example:

"12345678-1234-1234-1234-123456789012"

​
X-Frankie-CustomerChildID
string

Your Customer Child ID provided by FrankieOne

Example:

"87654321-4321-4321-4321-210987654321"

​
X-Frankie-Channel
string

Open string that can be used to define the "channel" the request comes in from. It can potentially be used in routing and risk calculations upon request. Default values that can be used are: api portal smartui Any alphanumeric string is supported though. Anything over 64 characters will be truncated.

Path Parameters

​
entityId
string
required

Unique FrankieOne identifier for an entity

Body

application/json
​
externalReferences
object[]

Response

OK

​
requestId
string
required

The unique request identifier for the API call made.

Example:

"01HN9XHZN6MGXM9JXG50K59Q85"

​
organization
object

This is the complete Organization Model