list-aws-organizations
dci list-aws-organizations [flags]
Returns all AWS Organizations accessible to the authenticated tenant.
Each item includes metadata, trailing 30-day aggregate statistics, precomputed
YTD/lifetime savings totals per SP type so customer-level savings can be aggregated
client-side by summing across organizations, and estimated monthly potential
savings (monthlyPotentialSavings) per SP type from the latest projection.
Flags
--page-token: (string)
--max-results: (integer default:50)
Output
List of AWS Organizations.
By default dci renders the result as a table. Use --output json to get the full structure described below — see Output formats.
| Field | Type | Description |
|---|---|---|
items | array of object | |
items[].managementAccountId | string | 12-digit account number of the organization's management (payer) account. |
items[].displayName | string | Human-readable account alias, if available. |
items[].onboardingStatus | object | Per-product-line PS4C onboarding state for this organization. |
items[].onboardingStatus.compute | object | Per-product-line PS4C onboarding state. |
items[].onboardingStatus.compute.status | string | Current onboarding lifecycle stage for this product line. One of: "not_started", "onboarding", "done", "error". |
items[].onboardingStatus.compute.onboardingStartedAt | string (date-time) | When PS4C first began tracking commitments for this product line. Used to bound lifetime savings totals and to render onboarding history in the DoiT Console. |
items[].onboardingStatus.database | object | Per-product-line PS4C onboarding state. |
items[].onboardingStatus.database.status | string | Current onboarding lifecycle stage for this product line. One of: "not_started", "onboarding", "done", "error". |
items[].onboardingStatus.database.onboardingStartedAt | string (date-time) | When PS4C first began tracking commitments for this product line. Used to bound lifetime savings totals and to render onboarding history in the DoiT Console. |
items[].savingsPlansSyncTime | string (date-time) | Timestamp of the last successful Savings Plan inventory sync. |
items[].stats30d | object | Trailing 30-day aggregate metrics, broken down by SP type. |
items[].stats30d.compute | object | Minimal 30-day aggregate. Only esr and savings are persisted at this granularity. Responses are denominated in USD. Used by both AWS organization/member-account and GCP billing-account list items. |
items[].stats30d.compute.esr | number (double) | Effective Savings Rate over the last 30 days (0–1). |
items[].stats30d.compute.savings | object | Realized savings amount over the last 30 days. Nested fields omitted — see the raw JSON schema. |
items[].stats30d.database | object | Minimal 30-day aggregate. Only esr and savings are persisted at this granularity. Responses are denominated in USD. Used by both AWS organization/member-account and GCP billing-account list items. |
items[].stats30d.database.esr | number (double) | Effective Savings Rate over the last 30 days (0–1). |
items[].stats30d.database.savings | object | Realized savings amount over the last 30 days. Nested fields omitted — see the raw JSON schema. |
items[].savingsTotals | object | Year-to-date and lifetime savings per SP type. Same figures the detail endpoint returns — surfaced on the list item so callers can compute customer-level totals (sum across organizations) without an extra round-trip per organization. Lifetime is bounded by each organization's PS4C onboarding start. |
items[].savingsTotals.compute | object | Running savings figures derived server-side from the full monthly stats history (onDemandCost - costWithSavings per month, optionally bounded by onboarding start date and start of year). |
items[].savingsTotals.compute.ytd | object | Year-to-date realized savings. Nested fields omitted — see the raw JSON schema. |
items[].savingsTotals.compute.lifetime | object | Lifetime realized savings since onboarding. Nested fields omitted — see the raw JSON schema. |
items[].savingsTotals.database | object | Running savings figures derived server-side from the full monthly stats history (onDemandCost - costWithSavings per month, optionally bounded by onboarding start date and start of year). |
items[].savingsTotals.database.ytd | object | Year-to-date realized savings. Nested fields omitted — see the raw JSON schema. |
items[].savingsTotals.database.lifetime | object | Lifetime realized savings since onboarding. Nested fields omitted — see the raw JSON schema. |
items[].monthlyPotentialSavings | object | Estimated monthly additional savings per SP type for this organization. |
items[].monthlyPotentialSavings.compute | object | |
items[].monthlyPotentialSavings.compute.amount | string | Decimal monetary amount at ISO 4217 minor-unit precision (string). |
items[].monthlyPotentialSavings.compute.currency | string | ISO 4217 currency code. |
items[].monthlyPotentialSavings.database | object | |
items[].monthlyPotentialSavings.database.amount | string | Decimal monetary amount at ISO 4217 minor-unit precision (string). |
items[].monthlyPotentialSavings.database.currency | string | ISO 4217 currency code. |
pageToken | string | |
rowCount | integer (int64) | Best-effort count for the filtered result set. May be null or omitted for expensive counts. |
Raw JSON schema
{
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"managementAccountId"
],
"properties": {
"managementAccountId": {
"type": "string",
"description": "12-digit account number of the organization's management (payer) account.",
"example": "123456789012"
},
"displayName": {
"type": "string",
"description": "Human-readable account alias, if available.",
"nullable": true,
"example": "Acme Prod"
},
"onboardingStatus": {
"allOf": [
{
"type": "object",
"description": "PS4C onboarding state grouped by product line. A product line is omitted when it\nis not onboarded at all.\n",
"properties": {
"compute": {
"type": "object",
"required": [
"status"
],
"description": "Per-product-line PS4C onboarding state.",
"properties": {
"status": {
"type": "string",
"description": "Current onboarding lifecycle stage for this product line.",
"enum": [
"not_started",
"onboarding",
"done",
"error"
]
},
"onboardingStartedAt": {
"type": "string",
"format": "date-time",
"description": "When PS4C first began tracking commitments for this product line. Used to bound\nlifetime savings totals and to render onboarding history in the DoiT Console.\n",
"nullable": true
}
}
},
"database": {
"type": "object",
"required": [
"status"
],
"description": "Per-product-line PS4C onboarding state.",
"properties": {
"status": {
"type": "string",
"description": "Current onboarding lifecycle stage for this product line.",
"enum": [
"not_started",
"onboarding",
"done",
"error"
]
},
"onboardingStartedAt": {
"type": "string",
"format": "date-time",
"description": "When PS4C first began tracking commitments for this product line. Used to bound\nlifetime savings totals and to render onboarding history in the DoiT Console.\n",
"nullable": true
}
}
}
}
}
],
"description": "Per-product-line PS4C onboarding state for this organization."
},
"savingsPlansSyncTime": {
"type": "string",
"format": "date-time",
"description": "Timestamp of the last successful Savings Plan inventory sync.",
"nullable": true
},
"stats30d": {
"type": "object",
"description": "Trailing 30-day aggregate metrics, broken down by SP type.",
"properties": {
"compute": {
"type": "object",
"description": "Minimal 30-day aggregate. Only `esr` and `savings` are persisted at this granularity.\nResponses are denominated in USD. Used by both AWS organization/member-account and GCP\nbilling-account list items.\n",
"properties": {
"esr": {
"type": "number",
"format": "double",
"description": "Effective Savings Rate over the last 30 days (0–1).",
"nullable": true,
"example": 0.187
},
"savings": {
"allOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
}
],
"description": "Realized savings amount over the last 30 days."
}
}
},
"database": {
"type": "object",
"description": "Minimal 30-day aggregate. Only `esr` and `savings` are persisted at this granularity.\nResponses are denominated in USD. Used by both AWS organization/member-account and GCP\nbilling-account list items.\n",
"properties": {
"esr": {
"type": "number",
"format": "double",
"description": "Effective Savings Rate over the last 30 days (0–1).",
"nullable": true,
"example": 0.187
},
"savings": {
"allOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
}
],
"description": "Realized savings amount over the last 30 days."
}
}
}
}
},
"savingsTotals": {
"type": "object",
"description": "Year-to-date and lifetime savings per SP type. Same figures the detail\nendpoint returns — surfaced on the list item so callers can compute\ncustomer-level totals (sum across organizations) without an extra\nround-trip per organization. Lifetime is bounded by each organization's PS4C\nonboarding start.\n",
"properties": {
"compute": {
"type": "object",
"required": [
"ytd",
"lifetime"
],
"description": "Running savings figures derived server-side from the full monthly stats history\n(`onDemandCost - costWithSavings` per month, optionally bounded by onboarding\nstart date and start of year).\n",
"properties": {
"ytd": {
"allOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
}
],
"description": "Year-to-date realized savings."
},
"lifetime": {
"allOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
}
],
"description": "Lifetime realized savings since onboarding."
}
}
},
"database": {
"type": "object",
"required": [
"ytd",
"lifetime"
],
"description": "Running savings figures derived server-side from the full monthly stats history\n(`onDemandCost - costWithSavings` per month, optionally bounded by onboarding\nstart date and start of year).\n",
"properties": {
"ytd": {
"allOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
}
],
"description": "Year-to-date realized savings."
},
"lifetime": {
"allOf": [
{
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
}
],
"description": "Lifetime realized savings since onboarding."
}
}
}
}
},
"monthlyPotentialSavings": {
"allOf": [
{
"type": "object",
"description": "Estimated monthly additional savings per SP type, taken from the latest PS4C purchase\nprojection. Unlike `savingsTotals` (realized YTD/lifetime savings), this is a forward-looking\nestimate of the monthly savings achievable if the recommended commitments were purchased. For\nmember accounts, the organization figure is attributed by each member account's share of\ntrailing-60-day SP-eligible on-demand cost. A per-SP-type value of `0.00` means the latest\nprojection is missing, expired, or empty. The field is omitted entirely only for accounts that\nhave never had potential savings computed.\n",
"properties": {
"compute": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
},
"database": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^-?(0|[1-9]\\d*)(\\.\\d+)?$",
"description": "Decimal monetary amount at ISO 4217 minor-unit precision (string)."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code.",
"example": "USD"
}
}
}
}
}
],
"description": "Estimated monthly additional savings per SP type for this organization."
}
}
}
},
"pageToken": {
"type": "string",
"nullable": true
},
"rowCount": {
"type": "integer",
"format": "int64",
"description": "Best-effort count for the filtered result set. May be null or omitted for expensive counts.",
"nullable": true
}
}
}
Errors
On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.
| HTTP status | Exit code | Error code | Meaning |
|---|---|---|---|
| 400 | 30 | VALIDATION_ERROR | The arguments or request body were rejected. Review the command's flags and payload. |
| 401 | 10 | AUTHENTICATION_FAILED | Not signed in, or the API token is invalid. Run dci login or check DCI_API_KEY. |
| 403 | 11 | PERMISSION_DENIED | The DoiT user or the active customer context does not have access. |
| 500, 503 | 40 | API_SERVER_ERROR | The API failed to process the request. Retryable; contact DoiT support if it persists. |
Aliases: listawsorganizations