Skip to main content

General Usage

This documentation helps you interact with the REST API to manage your Vetrol account. It shows you how to set up your development environment, build and protect your work, and scale and extend your applications.

If you're a new developer, explore the Vetrol product portfolio to see what you can build with Vetrol.

Get started with Vetrol​

If you're just getting started with Vetrol, complete the following steps in one of our quickstarts. Choose the product you're most interested in and complete the following steps:

Manage your account and applications with the API​

Once you have an account set up, you can use the REST API to manage all aspects of your Vetrol account and applications. Explore the API reference to learn about available resources.

  • Messaging API — Send and receive messages across channels
  • Payments API — Process payments and manage transactions
  • Auth API — Handle authentication and identity verification
  • Webhooks — Receive real-time event notifications

Authentication​

All requests to the Vetrol API must be authenticated. Vetrol uses HTTP Basic Auth with your Account SID as the username and your Auth Token as the password.

curl -X GET https://api.vetrol.io/v1/messages \
  -u "$VETROL_ACCOUNT_SID:$VETROL_AUTH_TOKEN"

Your credentials are available in the Vetrol Console.

Keep your credentials secure

Never commit your Auth Token to source control. Use environment variables to store credentials safely.

Base URL​

All API requests are made to:

https://api.vetrol.io/v1

Response format​

The Vetrol API returns JSON-encoded responses with appropriate HTTP status codes.

{
  "sid": "MSG1234567890abcdef",
  "status": "sent",
  "to": "+1234567890",
  "from": "+0987654321",
  "body": "Hello from Vetrol!",
  "created_at": "2026-03-13T17:00:00Z"
}

Next steps​

Last updated on