API Documentation · v1.0

Getting started

• Introduction
• Obtaining an API token
• Authentication
• Supported programming languages

Introduction

The Addrow API lets you manage invoices and contacts (customers) through a simple REST API. The current version is 1.0.

Base URL: https://addrow.io/api/1.0

Obtaining an API token

Create a personal access token under Account → API. Give the token a name (for example “Zapier”), copy it once when it is shown, and store it safely. You will not be able to see the full token again.

Legacy long-lived API keys still work for existing integrations, but new setups should use personal access tokens. You can revoke either type from the same page.

Authentication

Send the token as a Bearer token in the Authorization header on every request.

curl -X GET "https://addrow.io/api/1.0/customers" \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/json"

Unauthenticated or invalid tokens receive 401 Unauthenticated.

Supported programming languages

Any language that can make HTTPS requests works. There are no official SDKs yet. Examples below use cURL-style snippets; the same headers apply everywhere.

PHP

Using Guzzle:

$client = new \GuzzleHttp\Client();
$response = $client->get("https://addrow.io/api/1.0/customers", [
    'headers' => [
        'Authorization' => 'Bearer {token}',
        'Accept' => 'application/json',
    ],
]);
$body = $response->getBody();
print_r(json_decode((string) $body));

JavaScript

const url = "https://addrow.io/api/1.0/customers";

fetch(url, {
    method: "GET",
    headers: {
        "Authorization": "Bearer {token}",
        "Accept": "application/json",
    },
})
    .then((response) => response.json())
    .then((json) => console.log(json));