Batch Lookup Groups | termina

1 import requests 2 3 url = "https://app.termina.ai/api/v1/group/batch-lookup" 4 5 payload = { "group_ids": [1, 2, 3] } 6 headers = { 7 "Authorization": "Bearer <token>", 8 "Content-Type": "application/json" 9 } 10 11 response = requests.post(url, json=payload, headers=headers) 12 13 print(response.json())

1 { 2 "total_count": 1, 3 "page": 1, 4 "page_size": 1, 5 "data": [ 6 { 7 "name": "string", 8 "account": "example.com", 9 "id": 1, 10 "account_manager": { 11 "name": "string", 12 "email": "string", 13 "id": 1, 14 "api_key_final_characters": "string", 15 "thumbnail_url": "string", 16 "created_at": "2024-01-15T09:30:00Z", 17 "updated_at": "2024-01-15T09:30:00Z", 18 "is_archived": true, 19 "super_user": true 20 }, 21 "user_count": 1, 22 "deal_count": 1, 23 "thumbnail_url": "string", 24 "analysis_email": "string", 25 "data_api_access": true, 26 "created_at": "2024-01-15T09:30:00Z", 27 "updated_at": "2024-01-15T09:30:00Z", 28 "is_archived": true 29 } 30 ] 31 }

Batch lookup groups by IDs with pagination.

Returns only groups the user has membership in. Silently filters out groups without access (no errors for inaccessible groups).

Super users can see all groups.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query Parameters

sort_bystring or nullOptional

sort_orderstringOptionalformat: "^(asc|desc)$"Defaults to asc

pageintegerOptional>=1Defaults to 1

page_sizeintegerOptional>=1Defaults to 100

Request

This endpoint expects an object.

group_idslist of integersRequired

List of group IDs to retrieve

Response

Successful Response

total_countinteger

pageinteger

page_sizeinteger

datalist of objects

Authentication

Query Parameters

Request

Response

Errors