List all teammates

GET https://api.tamio.com/v2/teammates/list

Returns a paginated list of teammates. Supports filtering by date range and free-text search across names, emails, and roles.

Query Parameters

page integer*

Page number for pagination.

per_page integer*

Number of teammates per page.

order string

Sort direction.

ascdesc

from string

Start date filter (ISO 8601 string or Unix timestamp).

to string

End date filter (ISO 8601 string or Unix timestamp).

filter string

Free-text search across teammate names, emails, or roles.

Responses

200 Paginated list of teammates

Paginated list of teammates

status integer

total_results integer

Total number of teammates matching the query.

teammates array of Teammate

id string

Unique identifier of the teammate.

object string

Object type identifier.

email string

Email address of the teammate.

name string

First name of the teammate.

last_name string

Last name of the teammate.

country string

ISO country code.

last_login integer

Unix timestamp of the last login. Null if the teammate has never logged in.

role string

The teammate's assigned role.

accountantdevelopermarketerguestfulfilmentadministrator

custom

verified boolean

Whether the teammate has activated their account by accepting the invitation.

permissions object

Granular permission object returned when the teammate has a custom role. Each key is a business area (e.g. products, invoices, customers) containing boolean flags such as view, edit, create, remove. Some areas also support resource-level overrides keyed by UUID. Null for predefined roles.

401 Missing or invalid API key

Retrieve a teammate

/teammates/list

1 const response = await fetch("https://api.tamio.com/v2/teammates/list", {
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/teammates/list")
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,
  "total_results": 5,
  "teammates": [
    {
      "id": "aaa14567-e89b-12d3-a456-426614174000",
      "object": "teammate",
      "email": "[email protected]",
      "name": "John",
      "last_name": "Doe",
      "country": "US",
      "last_login": 1711929600,
      "role": "developer",
      "verified": true,
      "permissions": {
        "products": {
          "view": true,
          "edit": true,
          "create": true,
          "remove": false
        },
        "invoices": {
          "view": true,
          "edit": false,
          "create": false,
          "remove": false
        }
      }
    }
  ]
}

1	const response = await fetch("https://api.tamio.com/v2/teammates/list", {
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/teammates/list")
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