Send your first Augno API request

Get started with the Augno API.

To interact with the Augno API, you'll need a secret API key. Once you sign up for an Augno account, we provide you with keys for both testing and live environments. Before diving into production, ensure your account is activated.

Preparation

This guide will walk you through listing units of measurement using the List UnitsAPI endpoint. For a comprehensive understanding of how Augno API components work together, consider taking an API tour or visiting the API referenceAPI.

Making your first API request

Begin your interaction with the Augno API by sending HTTP requests to the designated endpoints.

Upon success, expect a response like this:

{
    "object": "list",
    "page_info": {
        "next_cursor": "unit_01jm4r6700f8nwq3v5hx2d9ktp",
        "prev_cursor": null,
        "has_next_page": true,
        "has_prev_page": false
    },
    "data": [
        {
            "id": "unit_01jm4r6700f8nwq3v5hx2d9ktp",
            "object": "unit",
            "name": "Kilogram",
            "abbreviation": "kg",
            "type": "mass",
            "ratio_numerator": "1000.000000000000000000000000000000",
            "ratio_denominator": "1.000000000000000000000000000000",
            "offset_numerator": "0.000000000000000000000000000000",
            "offset_denominator": "1.000000000000000000000000000000",
            "is_base_unit": false,
            "is_internal": false,
            "created_at": "2026-05-10T00:00:00Z",
            "updated_at": "2026-05-10T00:23:00Z"
        }
    ]
}

Monitoring your requests

Every API request you make is logged and generates an event for your organization account. The API key you use determines whether the data is stored in a sandbox or production environment. For example, using a test API key creates data in the test environment.

To review your API request logs, visit the logs page. For event details, check the events page.

Managing your API keys

Each account is equipped with two API keys: one for sandbox testing and another for live production.

  • Sandbox Secret Key: Ideal for testing in a sandbox environment, this key allows unrestricted API requests. Use it for development to prevent accidental changes to live data.
  • Production Secret Key: This key is for live mode requests and also allows unrestricted API requests.

Access your secret and publishable keys in the Dashboard under the API keys tab. If you can't see your keys, request the necessary permissions from your organization account owner.

When logged into Augno, our documentation will automatically populate code examples with your sandbox API key. These values are visible only to you. If you're not logged in, the examples will use placeholder API keys. Replace these with your own keys or log in to see your personalized keys.

The following uses placeholder API keys.
TypeValueUsage
Secretaug_sk_test_AM4B...WNXDSandbox