GuidesAPI ReferenceChangelogDiscussions
Log In
API Reference

TIN verification request completed

wbhk
tinVerificationFinished

Fired when a TIN verification request finishes processing (either successfully or with an error). The payload contains the request ID and final status. Use GET /tin_verifications/{id} to fetch the full results.

Payload

Notification that a TIN verification request has reached a terminal state. Use GET /tin_verifications/{id} to fetch the full results.

string
required
Defaults to tin_verification.finished

Code that describes the event.

integer
required

Unix timestamp indicating when the event was triggered.

data
object
required

Minimal payload with the request ID and final status. Fetch full results via GET /tin_verifications/{id}.

Headers
string
required

Contains a signature to verify the authenticity and integrity of the request. The signature is generated using the HMAC-SHA256 algorithm with a payload composed of the timestamp and the JSON data. Format: t={timestamp},s={signature}.

Responses
200

Return a 200 status to indicate that the data was received successfully

404

The webhook URL could not be reached. Ensure the URL is correct and reachable.

Updated about 4 hours ago 

LoadingLoading…

Updated about 4 hours ago