Operations API Customers

Retrieve a customer

GET https://api.tamio.com/v2/customers/retrieve/{uuid}

Retrieves a single customer by UUID, including addresses, direct debits, affiliate information, and client details.

Path Parameters

uuid string*

Responses

200 Customer retrieved successfully

Customer retrieved successfully

status integer

customer Customer

400 Validation or business-logic error. Possible `error_code` values:

401 Unauthorized – invalid or missing Bearer token

Update a customer

Delete a customer

/customers/retrieve/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/customers/retrieve/{uuid}", {
2   headers: {
3     "Authorization": "Bearer YOUR_API_KEY",
4     "Accept": "application/json"
5   }
6 });
7 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/customers/retrieve/{uuid}")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Get.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200,
  "customer": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "object": "customer",
    "email": "john.doe@example.com",
    "name": "John",
    "last_name": "Doe",
    "country": "de",
    "locale": "en",
    "timezone_offset": "+00:00",
    "category": "customer",
    "priority": "normal",
    "lead_status": "string",
    "phone": "+49123456789",
    "stripe_customer_id": "string",
    "teammate_id": "string",
    "affiliate_partner_id": "string",
    "has_notes": false,
    "created_at": 1700000000,
    "billing_address": {
      "id": "string",
      "object": "address",
      "name": "string",
      "last_name": "string",
      "email": "string",
      "address": "string",
      "city": "string",
      "postcode": "string",
      "state": "string",
      "country": "string",
      "locale": "string",
      "phone": "string",
      "company": "string",
      "message": "string",
      "shipping_address": false,
      "is_company": false,
      "vat": "string",
      "verified_vat": false,
      "representative": "string"
    },
    "shipping_address": {
      "id": "string",
      "object": "address",
      "name": "string",
      "last_name": "string",
      "email": "string",
      "address": "string",
      "city": "string",
      "postcode": "string",
      "state": "string",
      "country": "string",
      "locale": "string",
      "phone": "string",
      "company": "string",
      "message": "string",
      "shipping_address": false,
      "is_company": false,
      "vat": "string",
      "verified_vat": false,
      "representative": "string"
    },
    "direct_debits": [],
    "client_id": "string"
  }
}

1	const response = await fetch("https://api.tamio.com/v2/customers/retrieve/{uuid}", {
2	headers: {
3	"Authorization": "Bearer YOUR_API_KEY",
4	"Accept": "application/json"
5	}
6	});
7	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/customers/retrieve/{uuid}")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Get.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body