Resources | API & MCP Reference | Archera

API for retrieving and analyzing infrastructure resources

/resources

get/v1/org/{org_id}/resources

Retrieves a list of infrastructure resources for the organization, including compute instances, databases, and other services with their current status and costs.

Path parameters

• org_id: string · uuid (Required)

Query parameters

• provider: string · enum (Optional)
  Filter by provider
  Example: aws
  Possible values: aws, azure, gcp

• segment_id: string · uuid (Optional)
  Filter by segment ID
  Example: 550e8400-e29b-41d4-a716-446655440000

• search: string (Optional)
  Text to search across multiple columns (case-insensitive partial match)
  Example: us-east-1

• desc: boolean · nullable (Optional)
  Sort in descending order if true
  Default: null
  Example: true

• order_by: string|null · enum · nullable (Optional)
  Field to order results by
  Default: id
  Example: id
  Possible values: id, usage_start, null

• page: integer · min: 1 (Optional)
  Default: 1

• page_size: integer · min: 1 · max: 100 (Optional)
  Default: 20

Responses

• 200 OK
  application/json

Example Response:

[
  {
    "id": "text",
    "resource_id": "123e4567-e89b-12d3-a456-426614174000",
    "provider": "aws",
    "provider_resource_id": "arn:aws:ec2:us-west-2:123456789012:instance/i-1234567890abcdef0",
    "is_spot": true,
    "name": null,
    "resource_group": null,
    "usage_end": "2026-07-27",
    "usage_start": "2026-07-27",
    "tags": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "created_at": "2026-07-27",
    "updated_at": "2026-07-27",
    "instance_id": "text",
    "billing_account_id": "text",
    "sub_account_id": "text",
    "sku_title": "text",
    "sku_name": null,
    "availability_zone": null,
    "cache_engine": null,
    "database_engine": null,
    "description": null,
    "family": null,
    "full_region_name": null,
    "has_ondemand_terms": null,
    "instance_type": null,
    "instance_type_family": null,
    "is_reservable": null,
    "license_model": null,
    "location_type": null,
    "normalization_size_factor": null,
    "operating_system": null,
    "pre_installed_sw": null,
    "price_currency": null,
    "provider_service": null,
    "provider_sku_id": null,
    "publication_date": null,
    "region": null,
    "service": null,
    "tenancy": null,
    "usage_type": null,
    "version": null,
    "vpc_networking_support": null,
    "ondemand_usage_unit": null
  }
]

/resources/{resource_id}/daily-usage

get/v1/org/{org_id}/resources/{resource_id}/daily-usage

Retrieves daily usage data for a specific resource within the specified date range. Optionally filter by catalog_sku_id to get usage for a specific SKU. Including usage metrics, costs, and coverage information.

Path parameters

• org_id: string · uuid (Required)
• resource_id: string · uuid (Required)

Query parameters

• start_date: string · date (Required)
  Start date for the date range filter (inclusive)
  Example: 2024-01-01

• end_date: string · date (Required)
  End date for the date range filter (inclusive)
  Example: 2024-01-31

• catalog_sku_id: string · nullable (Optional)
  Optional catalog SKU ID to filter daily usage records for a specific SKU
  Example: 550e8400-e29b-41d4-a716-446655440000

• page: integer · min: 1 (Optional)
  Default: 1

• page_size: integer · min: 1 · max: 10000 (Optional)
  Default: 100

Responses

• 200 OK
  application/json

Example Response:

[
  {
    "date": "2026-07-27",
    "sub_account_id": "text",
    "usage": 1,
    "reservation_usage": 1,
    "free_tier_usage": 1,
    "ondemand_cost": 1,
    "reserved_cost": 1,
    "if_all_ondemand_cost": 1,
    "spot_cost": 1,
    "free_tier_savings": 1,
    "usage_type": null,
    "common_usage_type": null,
    "covered_usage": 1,
    "uptime": 1
  }
]