This API endpoint allows you to verify the existence of a specific hash within the system. It accepts a JSON payload containing the hash to be verified. Upon receiving the request, the system checks whether the submitted hash exists in the database and blockchain and returns the corresponding verification result.

Request

• Method: POST
• URL: /verify-endpoint
• Headers:
  • Authorization: Bearer token for API authentication (required)
  • Content-Type: application/json
• Body Parameters:
  • hash (string, required): The SHA-256 hash to verify.

Example Request:

curl --request POST \\
  --url <http://aerodox.application.trustion-validate.com/verify-endpoint> \\
  --header 'Authorization: Bearer <token>' \\
  --header 'Content-Type: application/json' \\
  --header 'User-Agent: insomnia/11.2.0' \\
  --data '{
	"hash": "6bebb77f8c3a9bdc66f458f9697eea9d1004ce20123b34a8eac5faf273c3aa46"
}'

Response:

Response Fields

• success (boolean): Indicates whether the verification was successful.
• data (array): A list of matching records containing:
  • filename (string): Name of the file associated with the hash.
  • hash (string): The verified hash value.
  • context_input (stringified JSON): Additional context data provided during the initial hash registration.
  • date_created (string, ISO 8601): Timestamp when the hash was registered.
  • user_created (object): Information about the user who registered the hash:
    • id (string): User ID.
    • email (string): User’s email address.
    • first_name (string): User’s first name.
    • last_name (string): User’s last name.
    • organisation (object): Organisation details:
      • id (string): Organisation ID.
      • company_name (string): Name of the organisation.

Example response:

{
	"success": true,
	"data": [
		{
			"filename": "test-doc-2.pdf",
			"hash": "6bebb77f8c3a9bdc66f458f9697eea9d1004ce20123b34a8eac5faf273c3aa46",
			"context_input": "{\\"context\\":\\"\\",\\"input\\":[]}",
			"date_created": "2025-06-11T21:55:06.384Z",
			"user_created": {
				"id": "4b77b701-f796-473f-aa3e-7e8604678acf",
				"email": "[email protected]",
				"first_name": "Bob",
				"last_name": "van der Valk",
				"organisation": {
					"id": "a1e4977f-71e6-4f2e-8120-67eb82e73f1f",
					"company_name": "Trustion Validate"
				}
			}
		}
	]
}