# API Documentation

## Docs

- [Authentication](https://docs-staging.termii.com/api-reference/authentication.md): The Termii API uses API keys to authenticate requests. You can view and manage your API keys in the [Termii Dashboard](https://app.termii.com/). API calls are authenticated by including your API key in the body of the request you make. If you do not include your API key when making an API request or…
- [Error](https://docs-staging.termii.com/api-reference/error.md): Termii uses HTTP response codes to indicate the success or failure of requests. In general:
- [Get Balance](https://docs-staging.termii.com/api-reference/insight/get-balance.md)
- [Get_sender_id_just_created](https://docs-staging.termii.com/api-reference/messaging/get_sender_id_just_created.md)
- [Request a sender id](https://docs-staging.termii.com/api-reference/messaging/request-a-sender-id.md): This endpoint requests a sender id.
- [Send (number)](https://docs-staging.termii.com/api-reference/messaging/send-number.md)
- [Template](https://docs-staging.termii.com/api-reference/templates/template.md)
- [Welcome](https://docs-staging.termii.com/api-reference/welcome.md): Learn how to integrate our APIs into your application.
- [Incoming](https://docs-staging.termii.com/conversations/incoming.md)
- [Introduction](https://docs-staging.termii.com/conversations/introduction.md): Receive inbound messages (WhatsApp & SMS) directly in your application through your set webhook url
- [Introduction](https://docs-staging.termii.com/introduction.md): These docs will give you a deep dive into our full API Reference Documentation and how to seamlessly integrate our messaging channels and verification functionalities into your product.
- [Sotel](https://docs-staging.termii.com/sotel/introduction.md): Sotel eSIMs API simplifies eSIM management by enabling businesses to activate, provision, and switch eSIMs across global networks. This API allows fintechs, banks, travel agencies, tourism companies, and aviation firms to seamlessly offer eSIMs to their customers, providing a streamlined and scalabl…
- [Balance](https://docs-staging.termii.com/switch/insights/balance.md): The Balance API returns your total balance and balance information from your wallet, such as currency.
- [Events and Report](https://docs-staging.termii.com/switch/insights/events-and-reports.md)
- [History](https://docs-staging.termii.com/switch/insights/history.md): This Inbox API returns reports for messages sent across the sms, voice & whatsapp channels. Reports can either display all messages on termii or a single message.
- [Introduction](https://docs-staging.termii.com/switch/insights/introduction.md): Retrieve real-time delivery report of messages sent to customers as well as the status of their contacts.
- [Search](https://docs-staging.termii.com/switch/insights/search.md): The search API allows businesses verify phone numbers and automatically detect their status as well as current network. It also tells if the number has activated the do-not-disturb settings.
- [Status](https://docs-staging.termii.com/switch/insights/status.md): The status API allows businesses to detect if a number is fake or has ported to a new network.
- [Campaign](https://docs-staging.termii.com/switch/messaging/campaign-api/campaigns.md): Using our campaign APIs, you can view, manage and send a campaign to a phonebook.
- [Contacts](https://docs-staging.termii.com/switch/messaging/campaign-api/contacts.md): Contacts API allows you manage (i.e. edit, update, & delete) contacts in your phonebook.
- [Phonebook](https://docs-staging.termii.com/switch/messaging/campaign-api/phonebooks.md): Create, view & manage phonebooks using these APIs. Each phonebook can be identified by a unique ID, which makes it easier to edit or delete a phonebook.
- [Introduction](https://docs-staging.termii.com/switch/messaging/introduction.md): Termii’s Messaging allows you to send messages to any country in the world across SMS and WhatsApp channel through a REST API. Every request made is identified by a unique ID that help our users track the status of their message either by receiving Delivery Reports (DLRs) over their set webhook endp…
- [Messaging API](https://docs-staging.termii.com/switch/messaging/messaging-api.md): This API allows businesses send text messages to their customers across different messaging channels. The API accepts JSON request payload and returns JSON encoded responses, and uses standard HTTP response codes.
- [Sender ID API](https://docs-staging.termii.com/switch/messaging/sender-id-api.md): A Sender ID is the name or number that identifies the sender of an SMS message. This API allows businesses retrieve the status of all registered sender ID and request registration of sender ID through GET and POST request type respectively.
- [Templates API](https://docs-staging.termii.com/switch/messaging/templates-api.md): Templates API helps businesses set a template for the one-time-passwords (pins) sent to their customers via whatsapp or sms.
- [Email Token](https://docs-staging.termii.com/switch/token/email-token.md): The email token API enables you to send one-time-passwords from your application through our email channel to an email address. Only one-time-passwords (OTP) are allowed for now and these OTPs can not be verified using our Verify Token API.
- [In App Token](https://docs-staging.termii.com/switch/token/in-app-token.md): This API returns OTP codes in JSON format which can be used within any web or mobile app. Tokens are numeric or alpha-numeric codes generated to authenticate login requests and verify customer transactions.
- [Introduction](https://docs-staging.termii.com/switch/token/introduction.md): Token allows businesses generate, send and verify one-time-passwords.
- [Send Token](https://docs-staging.termii.com/switch/token/send-token.md): The send token API allows businesses trigger one-time-passwords (OTP) across any available messaging channel on Termii. One-time-passwords created are generated randomly and there's an option to set an expiry time.
- [Verify Token](https://docs-staging.termii.com/switch/token/verify-token.md): Verify token API, checks tokens sent to customers and returns a response confirming the status of the token. A token can either be confirmed as verified or expired based on the timer set for the token.
- [Voice Call](https://docs-staging.termii.com/switch/token/voice-call.md): The voice call API enables you to send messages from your application through our voice channel to a phone number. Only one-time-passwords (OTP) are allowed for now and these OTPs can not be verified using our Verify Token API.
- [Voice Token](https://docs-staging.termii.com/switch/token/voice-token.md): The voice token API enables you to generate and trigger one-time passwords (OTP) through the voice channel to a phone number. OTPs are generated and sent to the phone number and can only be verified using our Verify Token API.

## OpenAPI Specs

- [test_kdae1u](https://res.cloudinary.com/dgdteyucq/raw/upload/v1744131377/termii/test_kdae1u.json)

## Optional

- [Join Loop](https://termii-loop.slack.com/join/shared_invite/zt-imbqlf68-w4lsPkOzibBXSQohu8_8dQ#/shared-invite/email)