Last updated at: 2026-10-13
Query Organization List
Query the list of organizations accessible to the account that the current developer key belongs to.
Request Method
GET
Request URL
https://altatech.ai/v1/org/list
Request Authentication
Uses account-level DevKey / DevSecret Basic authentication.
Request
Request Example
curl -X GET 'https://altatech.ai/v1/org/list' \
-H 'Authorization: Basic ${BASIC_TOKEN}'
Request Headers
| Field | Type | Description |
|---|---|---|
| Authorization | Basic ${BASIC_TOKEN} | The Basic Token obtained by Base64-encoding DevKey:DevSecret. |
Request Parameters
None.
Response
Response Example
{
"code": 0,
"message": "OK",
"data": [
{
"org_id": "p-xxxx",
"org_name": "Demo Org",
"is_owner": true
}
]
}
Success Response
| Field | Type | Description |
|---|---|---|
| org_id | String | Organization ID, which must be passed in subsequent organization resource endpoints. |
| org_name | String | Organization name. |
| is_owner | Boolean | Whether the current account is the owner of the organization. |
Failure Response
| Field | Type | Description |
|---|---|---|
| code | Integer | Error code. |
| message | String | Error details. |
Status Codes
| Status Code | Description |
|---|---|
| 200 | Success |
| 400 | Parameter error |
| 401 | Unauthorized |
| 403 | Insufficient permissions |
| 429 | Too many requests |
| 500 | Server error |