---
title: "GET /billing/requests"
method: GET
path: "/billing/requests"
tags: ["Streams"]
---

# GET /billing/requests

`GET /billing/requests`

## Query parameters

- `limit` integer
- `offset` integer
- `assignee.id` string
- `batch.context.period.end` string, date-time
- `batch.context.period.start` string, date-time
- `batch.id` string
- `batch.name` string
- `events` string
- `events.created.at` string, date-time
- `events.updated.at` string, date-time
- `id` string
- `stats` string
- `status` 'scheduled' | 'pending' | 'completed' | 'published' | 'failed' | 'canceled'
- `stream.context.account.id` string
- `stream.context.account.name` string
- `stream.context.listing.id` string
- `stream.context.marketplace.id` string
- `stream.context.marketplace.name` string
- `stream.context.product.id` string
- `stream.context.product.name` string
- `stream.id` string
- `stream.name` string
- `stream.owner.id` string
- `transformation.columns` string
- `transformation.description` string
- `transformation.function.id` string
- `transformation.function.manual` boolean
- `transformation.position` integer
- `validation.status` 'pending' | 'processing' | 'success' | 'failed'

## Response `200`

- StreamsBillingTransformationRequest[]
  - `id` string
  - `status` 'scheduled' | 'pending' | 'completed' | 'published' | 'failed' | 'canceled'
  - `error` string
  - `assignee` StreamsActor, required
    - `id` string, required
    - `name` string, required
    - `icon` string, required
  - `files` StreamsTransformationRequestFiles, required
    - `input` string, binary
    - `output` string, binary, required
  - `batch` StreamsBillingExtendedBatchReference, required
    - `id` string
    - `name` string, required
    - `status` 'draft' | 'processing' | 'published' | 'failed' | 'deleted'
    - `context` StreamsBillingBatchContext, required
      - `period` StreamsBillingPeriod, required
        - `start` string, date-time, required
        - `end` string, date-time, required
  - `transformation` StreamsTransformation, required
    - `id` string, required
    - `description` string, nullable
    - `function` StreamsTransformationFunctionReference, required
      - `id` string
      - `name` string
      - `status` 'active' | 'decommissioned'
      - `icon` string, nullable
      - `manual` boolean, nullable
    - `overview` string, nullable — Markdown
    - `columns` string
    - `settings` object, nullable
    - `position` integer, nullable
  - `stream` StreamsBillingExtendedStreamReference, required
    - `id` string
    - `name` string, required
    - `status` 'configuring' | 'active' | 'terminated' | 'deleted'
    - `owner` StreamsAccountReference
      - `id` string, required
      - `name` string, required
      - `icon` string, nullable
    - `context` StreamsBillingStreamContext, required
      - `account` StreamsAccountReference, required
        - `id` string, required
        - `name` string, required
        - `icon` string, nullable
      - `product` StreamsProductReference, required
        - `id` string, required
        - `name` string, required
        - `icon` string, nullable
      - `marketplace` StreamsMarketplaceReference, required
        - `id` string, required
        - `name` string, required
        - `icon` string, nullable
        - `currency` string, nullable
      - `listing` StreamsListingReference, required
        - `id` string, required
  - `events` object
    - `created` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `updated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `scheduled` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `pended` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `completed` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `failed` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `canceled` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
  - `validation` StreamsTask
    - `name` string, required
    - `status` 'pending' | 'processing' | 'success' | 'failed'
    - `error` StreamsTaskError, required
      - `message` unknown
  - `stats` StreamsTransformationRequestStats, required
    - `rows` StreamsTransformationRequestRowsStats, required
      - `total` integer
      - `processed` integer, required

## Other responses

- `400`

---

[API](https://skmtc.net/cloudblue/apis/cloudblue-connect-api.md) · [All operations](https://skmtc.net/cloudblue/apis/cloudblue-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudblue/cloudblue-connect-api/revisions/0421d2a97c52/schema)