The Tentacle API is organised around REST principles. Our API provides predictable, resource-oriented URLs, accepts application/x-www-form-urlencoded or JSON request bodies, returns JSON-encoded responses, and uses standard HTTP status codes, authentication methods, and verbs.
The API enables integration with Tentacle’s operational security, incident management, station operations, and audit systems.
During development, you may use the Tentacle API in sandbox mode, which allows full testing without impacting live operational data.
If you encounter issues while developing against our APIs, please review the FAQs section below. If you are unable to resolve your issue, contact your designated support team member.
The Tentacle API uses secure API key authentication.
You can generate and manage your API credentials within your Tentacle Admin Dashboard.
Your API keys grant access to operational and security-sensitive data. Keep them secure and never expose secret keys in public repositories such as GitHub.
01
All API Requests:
- Must be made over HTTPS
- Must originate from a whitelisted IP address
- Must include valid authentication credentials
02
Requests made over HTTP, from unauthorised IPs, or without valid credentials will fail.
03
Required Authentication Parameters:
- ts_company_id
- ts_API_key
- ts_environment (0=production, 1=sandbox)
Tentacle uses conventional HTTP response codes to indicate success or failure. Status Code Guide:
2xx: - Request Successful
4xx – Client-side error (invalid parameters, authentication failure, etc.)
Heading: 200
Text Underneath: OK
Heading: 400
Text Underneath: Missing a required parameter
Heading: 401
Text Underneath: Invalid parameter format
Heading: 403
Text Underneath: Unauthorised request
Heading: 404
Text Underneath: Resource not found
Heading: 410
Text Underneath: Unauthorised IP address
Heading: 411
Text Underneath: Invalid Company ID
Heading: 412
Text Underneath: Invalid API Key
Heading: 420
Text Underneath: Request failed
Heading: 421
Text Underneath: Requested data not found
Heading: 430
Text Underneath: Rate limit exceeded
Heading: 500
Text Underneath: Internal server error
Tentacle AZGuard
A security and compliance platform designed to support audit readiness, regulatory alignment, and operational oversight in high-risk environments.
Tentacle AZGuard centralises controls, evidence, and performance indicators into a governed system
Tentacle AZGuard
A security and compliance platform designed to support audit readiness, regulatory alignment, and operational oversight in high-risk environments.
Tentacle AZGuard centralises controls, evidence, and performance indicators into a governed system
Tentacle AZGuard
A security and compliance platform designed to support audit readiness, regulatory alignment, and operational oversight in high-risk environments.
Tentacle AZGuard centralises controls, evidence, and performance indicators into a governed system
Tentacle AZGuard
A security and compliance platform designed to support audit readiness, regulatory alignment, and operational oversight in high-risk environments.
Tentacle AZGuard centralises controls, evidence, and performance indicators into a governed system
Tentacle AZGuard
A security and compliance platform designed to support audit readiness, regulatory alignment, and operational oversight in high-risk environments.
Tentacle AZGuard centralises controls, evidence, and performance indicators into a governed system
Tentacle AZGuard
A security and compliance platform designed to support audit readiness, regulatory alignment, and operational oversight in high-risk environments.
Tentacle AZGuard centralises controls, evidence, and performance indicators into a governed system