---
title: "Get usages for child orgs."
method: POST
path: "/v1/organizations/usages"
tags: ["orgsManagement"]
---

# Get usages for child orgs.

`POST /v1/organizations/usages`

Get the credits usage details of the child orgs for a parent.

## Request body

- ChildUsageDetailsRequest — The child usage details request for the parent account
  - `startDate` string — Start date, without the time, of the usage data to fetch.
  - `endDate` string — End date, without the time, of usage data to fetch.

## Response `200`

Usage details for the child orgs.

- ChildUsageDetailsResponse
  - `data` ChildUsageDetail[], required — Usage details of the child orgs.
    - `status` string, required — Status of the child org.
    - `orgName` string — Name of the child org.
    - `orgId` string, required — The unique identifier of an organization. It consists of the deployment ID and the hexadecimal account ID separated by a dash `-` character.
    - `allocatedCredits` number, double — Denotes the total number of credits provisioned for the child organization to use.
    - `usages` ChildUsage, required
      - `totalCreditsUsed` number, double, required — Total Credits used by the child org.
      - `usagePercentage` number, double — Percentage of used credits from the allocated credits.
      - `forecastPercentage` number, double — Forecasted percentage of credits will be used in the given time period.
      - `usagePercentChangeWoW` number, double — Week over week usage percentage for the subscription period.
      - `usagePercentChange` number, double — Percentage of usage change over the given time period.

## Other responses

- `default` — Operation failed with an error.

---

[API](https://skmtc.net/sumologic/apis/sumo-logic-api.md) · [All operations](https://skmtc.net/sumologic/apis/sumo-logic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumologic/sumo-logic-api/versions/18a824df1e78/schema)