API ReferenceProviders

Get provider-specific recommendations breakdown

GET
/api/v1/providers/{provider_id}/recommendations

Authorization

BearerAuth
AuthorizationBearer <token>

API key with l4_live_ or l4_test_ prefix

In: header

Path Parameters

provider_id*string

Query Parameters

start?|

Start date filter (ISO 8601 format: YYYY-MM-DD)

end?|

End date filter (ISO 8601 format: YYYY-MM-DD)

page?integer

Page number (1-indexed)

Default1
Range1 <= value
page_size?integer

Items per page (max 100)

Default10
Range1 <= value <= 100
sort_by?string

Field to sort by (recommendation_id, service, environment, account, tag, monthly_savings, savings_percentage, status)

Default"status"
sort_order?string

Sort order (asc or desc)

Default"asc"
Match^(asc|desc)$
service?array<>|

Filter by service(s) - can be repeated for multiple values

environment?array<>|

Filter by environment(s) - can be repeated for multiple values

account?array<>|

Filter by account(s) - can be repeated for multiple values

tag?array<>|

Filter by tag(s) - can be repeated for multiple values

display_status?array<>|

Filter by display status(es): available, pending, processing, optimized, rejected, unavailable

Header Parameters

authorization*string

Response Body

application/json

application/json

curl -X GET "https://api.levelfour.ai/api/v1/providers/string/recommendations" \  -H "authorization: string"
{
  "success": true,
  "timestamp": "2019-08-24T14:15:22Z",
  "data": {
    "total_savings": 0,
    "items": [
      {
        "recommendation_id": "string",
        "service": "string",
        "environment": "string",
        "account": "string",
        "tag": "string",
        "monthly_savings": 0,
        "savings_percentage": 0,
        "status": "string",
        "actions": {
          "description": "string",
          "overview": "string",
          "implementation_process": "string",
          "execution_method": "string",
          "key_takeaway": "string",
          "operational_impact": "string"
        },
        "terms_accepted_at": "string",
        "saving_accepted_by": "string"
      }
    ],
    "pagination": {
      "total_items": 0,
      "total_pages": 0,
      "current_page": 0,
      "page_size": 0,
      "has_next": true,
      "has_previous": true
    }
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}