Cycloid Organization Cloud Cost Management filter vaules API

The Organization Cloud Cost Management filter vaules API from Cycloid — 1 operation(s) for organization cloud cost management filter vaules.

Operations 1

GET /organizations/{organization_canonical}/cloud_cost_management/filter_values Get cloud cost management filter vaules #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/cycloid:cycloid-organization-cloud-cost-management-filter-vaules-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cycloid-organization-cloud-cost-management-filter-vaules-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: This is the Cycloid's API Reference. It provides descriptions, syntax, and usage examples for each of the actions and data types available within our console.
  title: Welcome!
  termsOfService: https://console.cycloid.io/terms
  contact:
    name: The Great Owl
    url: https://www.cycloid.io
    email: contact@cycloid.io
  license:
    name: Cycloid @copyrights
    url: https://cycloid.io
  version: '0'
servers:
- url: https://http-api.cycloid.io
security:
- api_key: []
- api_key_query: []
tags:
- name: Organization Cloud Cost Management filter vaules
paths:
  /organizations/{organization_canonical}/cloud_cost_management/filter_values:
    parameters:
    - $ref: '#/components/parameters/organization_canonical'
    get:
      description: Return a map with all the possible filter vaules
      tags:
      - Organization Cloud Cost Management filter vaules
      operationId: getCloudCostManagementFilterVaules
      parameters:
      - $ref: '#/components/parameters/timestamp_range_begin_query'
      - $ref: '#/components/parameters/timestamp_range_end_query'
      - $ref: '#/components/parameters/cost_projects_filter'
      - $ref: '#/components/parameters/cost_environments_filter'
      - $ref: '#/components/parameters/cost_components_filter'
      - $ref: '#/components/parameters/cost_services_filter'
      - $ref: '#/components/parameters/cost_tag_key_value_filter'
      - $ref: '#/components/parameters/cost_categories_filter'
      - $ref: '#/components/parameters/cost_master_accounts_filter'
      - $ref: '#/components/parameters/cost_linked_accounts_filter'
      - $ref: '#/components/parameters/cost_regions_filter'
      - $ref: '#/components/parameters/cost_resource_tagging_filter'
      - $ref: '#/components/parameters/cost_group_by_filter'
      - $ref: '#/components/parameters/cost_dashboard_filter_values'
      responses:
        '200':
          description: 'Cloud Cost Management histogram for a period of time and a single provider.

            '
          content:
            application/json:
              schema:
                type: object
                required:
                - data
                properties:
                  data:
                    $ref: '#/components/schemas/CloudCostManagementFilterValues'
              example:
                data:
                  components:
                  - storage
                  - compute
                  - containers
                  linked_account:
                  - acc1
                  - acc2
                  projects:
                  - proj1
                  - proj2
                  regions:
                  - us-east-1
                  - eu-west-1
                  tags:
                    key1:
                    - value1
                    - value2
                    key2:
                    - value1
                    - value2
                    - value3
                    key3:
                    - value1
        '403':
          $ref: '#/components/responses/not_enough_permissions'
        '422':
          $ref: '#/components/responses/unprocessable_entity'
        default:
          $ref: '#/components/responses/unexpected_error'
      summary: Get cloud cost management filter vaules
      x-summary-source: derived
components:
  parameters:
    cost_services_filter:
      description: The names of the services that you can use to filter and group your results.
      name: services
      in: query
      style: form
      explode: true
      schema:
        type: array
        items:
          type: string
    cost_components_filter:
      description: The names of the components that you can use to filter your results
      name: components
      in: query
      style: form
      explode: true
      schema:
        type: array
        items:
          type: string
    timestamp_range_end_query:
      description: The unix timestamp in milliseconds, which indicate the end of the time range.
      name: end
      in: query
      schema:
        type: integer
        format: uint64
    cost_tag_key_value_filter:
      description: The key and value of a tag concatenated by a ;.
      name: tags
      in: query
      style: form
      explode: true
      schema:
        type: array
        items:
          maxLength: 127
          minLength: 4
          pattern: ^[^;]+;[^;]+$
          type: string
    cost_categories_filter:
      description: The names of the categories that you can use to filter and group your results.
      name: categories
      in: query
      style: form
      explode: true
      schema:
        type: array
        items:
          enum:
          - other
          - compute
          - storage
          - database
          - dev_tools
          - networking
          - analytics
          - containers
          - machine_learning
          - multimedia
          - security
          type: string
    cost_resource_tagging_filter:
      description: Filter results by only tagged or not tagged resources
      name: resource_tagging
      in: query
      schema:
        type: string
        enum:
        - tagged_resources
        - untagged_resources
    cost_master_accounts_filter:
      description: The ids of the master accounts that you can use to filter your results
      name: master_accounts
      in: query
      style: form
      explode: true
      schema:
        type: array
        items:
          type: string
    cost_projects_filter:
      description: The names of the projects that you can use to filter your results
      name: projects
      in: query
      style: form
      explode: true
      schema:
        type: array
        items:
          type: string
    organization_canonical:
      description: A canonical of an organization.
      name: organization_canonical
      in: path
      required: true
      schema:
        type: string
        maxLength: 100
        minLength: 2
        pattern: ^[a-z0-9]([a-z0-9\-_]*[a-z0-9])?$
    cost_linked_accounts_filter:
      description: The ids of the linked accounts that you can use to filter your results
      name: linked_accounts
      in: query
      style: form
      explode: true
      schema:
        type: array
        items:
          type: string
    cost_group_by_filter:
      description: Represents a group when you specify a group by criteria, or in the response to a query with a specific grouping.
      name: group_by
      in: query
      style: form
      explode: true
      schema:
        type: array
        items:
          enum:
          - environment
          - service
          - instance_type
          - category
          - location
          - linked_account
          - project
          - record_type
          - component
          type: string
        uniqueItems: true
    cost_dashboard_filter_values:
      description: Specifies if the filter values are for the dashboard
      name: dashboard
      in: query
      schema:
        type: boolean
        default: false
    cost_environments_filter:
      description: The names of the environments that you can use to filter your results
      name: environments
      in: query
      style: form
      explode: true
      schema:
        type: array
        items:
          type: string
    cost_regions_filter:
      description: The names of the regions that you can use to filter your results
      name: regions
      in: query
      style: form
      explode: true
      schema:
        type: array
        items:
          type: string
    timestamp_range_begin_query:
      description: The unix timestamp in milliseconds, which indicate the start of the time range.
      name: begin
      in: query
      schema:
        type: integer
        format: uint64
  responses:
    not_enough_permissions:
      description: The authenticated user cannot perform the operation because, it doesn't have permissions for such operation.
      headers:
        Content-Length:
          description: The length of the response body in octets (8-bit bytes).
          schema:
            type: integer
            format: uint64
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorPayload'
          example:
            errors:
            - code: Unauthorized
              message: Not enough permissions to perform the operation
    unprocessable_entity:
      description: All the custom errors that are generated from the Cycloid API
      headers:
        Content-Length:
          description: The length of the response body in octets (8-bit bytes).
          schema:
            type: integer
            format: uint64
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorPayload'
          example:
            errors:
            - code: SomeCode
              message: some error
    unexpected_error:
      description: The response sent when an unexpected error happened, as known as an internal server error.
      headers:
        Content-Length:
          description: The length of the response body in octets (8-bit bytes).
          schema:
            type: integer
            format: uint64
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorPayload'
          example:
            errors:
            - code: Unexpected
              message: Server Internal error
  schemas:
    ErrorPayload:
      description: 'The payload used by the server to response to the client with an Error, those errors could be any of the ones listed [here](https://github.com/cycloidio/youdeploy-http-api/blob/develop/errors/code.go#L10), only the CODE of the error is the one that is guaranteed to not change between the same major version, the MESSAGE could change.

        '
      title: Error Payload
      required:
      - errors
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ErrorDetailsItem'
        request_id:
          type: string
    CloudCostManagementFilterValues:
      description: 'A collection of the values for which the cost can be filtered, i.e. all

        the providers, services, regions, etc... for one org.

        '
      title: CloudCostManagementFilterValues
      properties:
        categories:
          type: array
          items:
            type: string
        components:
          type: array
          items:
            type: string
        currencies:
          type: array
          items:
            type: string
        environments:
          type: array
          items:
            type: string
        instance_types:
          type: array
          items:
            type: string
        linked_accounts:
          type: array
          items:
            type: string
        linked_accounts_with_cp:
          type: object
        master_accounts:
          type: array
          items:
            type: string
        master_accounts_with_cp:
          type: object
        projects:
          type: array
          items:
            type: string
        providers:
          type: array
          items:
            type: string
        regions:
          type: array
          items:
            type: string
        resources:
          type: array
          items:
            type: string
        services:
          type: array
          items:
            type: string
        tags:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
    ErrorDetailsItem:
      description: Represents an item of the list of details of an error.
      title: Error details item
      required:
      - message
      - code
      properties:
        code:
          type: string
        details:
          type: array
          items:
            type: string
        message:
          type: string
  securitySchemes:
    api_key:
      description: The API authorization is done with JWT tokens
      type: apiKey
      name: Authorization
      in: header
    api_key_query:
      description: The API authorization is done with JWT tokens in the query string
      type: apiKey
      name: api_key
      in: query