Notes
  • Deleted submissions cannot be restored.
  • Deleted submissions are still subject to billing.
  • Deleted submissions will appear as “Deleted Submission” in the dashboard and GET/API responses.
  • Use this API with caution to avoid unintentionally deleting critical data.

1. Endpoint

DELETE/Submission
DELETE https://rest-api.argosidentity.com/v3/submission

2. Authentication

Include the API key in the x-api-key header:
x-api-key
x-api-key: {yourAPIKey}

3. Request Parameter

submissionId
string
required
Unique ID of the submission to be deleted
admin_name
string
Deleted the admin name
The admin_name is optional; however, it is necessary for the admin to specify the admin_name parameter in order to receive a webhook after a submission is deleted.

3-1. Data to be Deleted

  • Personal identity information (e.g., name, date of birth, gender, nationality)
  • Sensitive ID details (e.g., document number, serial number, barcode)
  • Image files (e.g., ID images, selfies)
  • AML data (if stored via AML options)

3-2. Data to be Retained

  • Basic data that cannot identify individuals, such as Submission ID, submission date, ID type, and ID Check approval status.

4. Request Example

DELETE/Submission
bash Request
curl --location --request DELETE 'https://rest-api.argosidentity.com/v3/submission?submission_id={submission_id}&admin_name={admin_name}' \
--header 'x-api-key: {yourAPIKey}'

5. Response

5-1. Success Response

result.json
{
    "message": "success",
    "content": "Submission {submissionID} deleted successfully.",
    "statusCode": 200
}

5-2. Error Response

If an error occurs, a 400 status code is returned along with details in the response body:
error.json
{
    "message": "not Exist Submission ID",
    "statusCode": 400
}

5-3. Error Codes

Error CodesDescription
not Exist Submission IDsubmission_id is missing
not Exist Submission DataNo data found for the specified submission_id
not Exist Project DataProject information is missing
delete Process FAILDeletion process failed (e.g., Meta Face ID deletion failure)