Skip to content
Aether Docs

List organizations

GET
/api/v1/organizations
curl --request GET \
  --url 'https://api.aetherplatform.cloud/api/v1/organizations?limit=50' \
  --header 'Authorization: Bearer <token>'

Lists organizations the authenticated principal can access.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
cursor
string format: uuid

Opaque cursor (a UUID) for pagination; pass back the prior page’s next_cursor.

limit
integer
default: 50 >= 1 <= 100

Maximum number of items per page (1-100, default 50).

Responses

Section titled “Responses”

200

Section titled “200”

A page of organizations.

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string format: uuid
name
required
string
slug
required
string
billing_email
string | null
vat_id
string | null
plan
required

Legacy organization field, always starter; not settable through the API and unrelated to a cluster’s package (plan on createCluster).

string
payment_mode
required

How the organization’s issued invoices are paid. manual (the default for every organization): a member pays each invoice through the pay endpoint. autocharge: the default payment method is charged automatically when an invoice is issued. Always present. Changed with payment_mode on updateOrganization.

string
Allowed values: manual autocharge
payment_mode_set_at

When a member last chose payment_mode explicitly. Omitted (not null) while the organization still carries the manual default that nobody chose. An automatic charge is only ever attempted for invoices issued at or after this instant.

string format: date-time
created_at
required
string format: date-time
updated_at
required
string format: date-time
next_cursor
string | null
Example
{
  "items": [
    {
      "payment_mode": "manual"
    }
  ]
}

401

Section titled “401”

Missing or invalid credentials.

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
status_url

The platform status page (https://status.aetherplatform.cloud). Present on 5xx answers written by the API’s error writer and on no other; absent, not null, on 4xx.

string format: uri
decline_code

The payment provider’s decline code. Present only on 402 payment_declined; it is its own field and is never folded into message.

string
invoice_id

Present on exactly these errors of the invoice pay and pay/confirm endpoints: 402 payment_declined, 402 payment_method_required, 409 invoice_already_paid, 409 invoice_not_issued, 409 invoice_below_minimum, 409 payment_not_in_flight, and 409 invoice_void when the void invoice was replaced. It is the id of the live invoice, which after a re-issue is the replacement and not the id in the request URL (on 409 invoice_void from pay/confirm it is the replacement’s id). Absent on every other error — 400 (including discount_code_invalid), 403, 404, the discount_* 409s, 409 invoice_void with no replacement (nothing live to name), every 5xx and 503 code — and never null.

string format: uuid
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ],
    "status_url": "https://example.com",
    "decline_code": "example",
    "invoice_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  }
}

403

Section titled “403”

email_unverified: the portal user’s e-mail address is not verified (see Authentication). API tokens are never refused here.

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
status_url

The platform status page (https://status.aetherplatform.cloud). Present on 5xx answers written by the API’s error writer and on no other; absent, not null, on 4xx.

string format: uri
decline_code

The payment provider’s decline code. Present only on 402 payment_declined; it is its own field and is never folded into message.

string
invoice_id

Present on exactly these errors of the invoice pay and pay/confirm endpoints: 402 payment_declined, 402 payment_method_required, 409 invoice_already_paid, 409 invoice_not_issued, 409 invoice_below_minimum, 409 payment_not_in_flight, and 409 invoice_void when the void invoice was replaced. It is the id of the live invoice, which after a re-issue is the replacement and not the id in the request URL (on 409 invoice_void from pay/confirm it is the replacement’s id). Absent on every other error — 400 (including discount_code_invalid), 403, 404, the discount_* 409s, 409 invoice_void with no replacement (nothing live to name), every 5xx and 503 code — and never null.

string format: uuid
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ],
    "status_url": "https://example.com",
    "decline_code": "example",
    "invoice_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  }
}