Budgets

Get all budgets

Changed on

Gets all budgets for a given parent. This will at most return a list of size 1 for a given parent.

get/budgets

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/budgets
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token)

Query parameters

parentstring required

Globally unique identifier for the budget's parent object. This currently can only be a project.

Response

Successfully retrieved the requested budgets.

Example response

{
  "data": [
    {
      "gid": "12345",
      "resource_type": "budget",
      "estimate": {
        "source": "tasks",
        "enabled": true,
        "units": "USD",
        "value": 100
      },
      "actual": {
        "billable_status_filter": "billable",
        "value": 100,
        "units": "USD"
      },
      "total": {
        "enabled": true,
        "value": 100,
        "units": "USD"
      },
      "parent": {
        "gid": "12345",
        "resource_type": "project",
        "name": "Stuff to buy",
        "resource_subtype": "default_project"
      }
    }
  ]
}

Changes

  • 2aac685725ecRevision changes
    • info

      added the optional property //////// to the response with the status