# List Funding Applications

`GET https://api.suger.cloud/org/{orgId}/fundingApplication`

List the organization's AWS funding applications: requests for funding programs such as MDF, POC, MAP, MPOPP:Grow and MPOPP:Activate, whether filed from the Fours console, Salesforce or HubSpot, or saved as drafts with CreateFundingApplicationDraft. Deleted applications are excluded; results are paginated. Each application carries `status` (DRAFT, PENDING_CREATE, CREATE_FAILED, PENDING_ACCEPTANCE, ACTION_REQUIRED, ACTIVE, REJECTED or CANCELLED), `approvalInfo`, `externalId` (the AWS benefit application id, empty until it reaches AWS Partner Central), `salesforceOpportunityId`, `hubspotDealId`, and `info.awsBenefitApplication` with the program's `BenefitId`, AWS's own `Status` and `Stage`, the program details and `AssociatedResources` (the ACE opportunity it is filed for). To check whether a request already exists for an opportunity before drafting one, filter on that opportunity, e.g. `q=(ilike info.AssociatedResources "O1234567")`; `q=(= status "DRAFT")` lists the drafts.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `page_size` | query | integer | no | Page size (default 20, max 100) |
| `page_number` | query | integer | no | Page number (default 1) |
| `qs` | query | string | no | Query style: 'json' or 'lisp' (default 'lisp') |
| `q` | query | string | no | Filter expression in the format specified by qs param |
| `ss` | query | string | no | Sort style: 'json' or 'simple' (default 'simple') |
| `s` | query | string | no | Sort expression in the format specified by ss param |

## Responses

### 200 — Success

Content-Type: `application/json` · Schema: `ListBaseResponse-FundingApplication`

**`ListBaseResponse-FundingApplication`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array<FundingApplication> | no |  |
| `page_number` | integer | no |  |
| `page_size` | integer | no |  |
| `total_count` | integer | no | TotalCount is the number of matching rows, counted up to ListCountCap. When TotalCountCapped is true it is that cap rather than the real total. |
| `total_count_capped` | boolean | no | TotalCountCapped reports that more rows match than TotalCount says: the count stopped at ListCountCap because an exact total costs a full scan of everything the filter matches. Clients should present TotalCount as a lower bound ("10,000+") when this is set. Omitted when false, so clients that predate the field are unaffected. |

**`FundingApplication`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `approvalInfo` | ApprovalInfo | no |  |
| `creationTime` | string | no | CreationTime holds the value of the "creation_time" field. |
| `errorMessages` | array<string> | no | ErrorMessages holds the value of the "error_messages" field. |
| `externalId` | string | no | ExternalID holds the value of the "external_id" field. |
| `hubspotDealId` | string | no | HubspotDealID holds the value of the "hubspot_deal_id" field. |
| `id` | string | no | ID of the ent. |
| `info` | FundingApplicationInfo | no |  |
| `lastUpdateTime` | string | no | LastUpdateTime holds the value of the "last_update_time" field. |
| `organizationId` | string | no | OrganizationID holds the value of the "organization_id" field. |
| `partner` | FundingapplicationPartner | no |  |
| `salesforceFundingId` | string | no | SalesforceFundingID holds the value of the "salesforce_funding_id" field. |
| `salesforceOpportunityId` | string | no | SalesforceOpportunityID holds the value of the "salesforce_opportunity_id" field. |
| `status` | string | no | Status holds the value of the "status" field. |

**`ApprovalInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `approvalStatus` | ApprovalStatus | no |  |
| `decisionDate` | string | no | DecisionDate is when the final approval/decline happened (nil when pending) Latest DecisionDate |
| `message` | string | no | Message is the reason or explanation provided when the approval status is set to Declined or Action Required. It always stores the latest message for the current status transition. Historical messages are stored in notification events. |
| `requestDate` | string | no | Latest RequestDate |

**`FundingApplicationInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `awsBenefitAllocation` | BenefitAllocation | no |  |
| `awsBenefitAllocations` | array<BenefitAllocation> | no | AWSBenefitAllocations is every allocation AWS gave the application, primary first; awsBenefitAllocation holds the primary (see MergeAWSBenefitAllocation) for readers that expect one. AWS can give one application several: a legacy MDF combo request has a cash and a credit pool, and AWS re-creates some credit allocations. Rows synced before this field existed leave it empty. |
| `awsBenefitApplication` | BenefitApplication | no |  |
| `cosellAgent` | FundingApplicationCosellAgentInfo | no |  |

**`BenefitAllocation`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ApplicableBenefitIds` | array<string> | no | The IDs of other benefits that this particular benefit allocation is applicable for. |
| `Arn` | string | no |  |
| `BenefitApplicationId` | string | no |  |
| `BenefitId` | string | no |  |
| `Catalog` | string | no |  |
| `CreatedAt` | string | no |  |
| `Description` | string | no |  |
| `ExpiresAt` | string | no |  |
| `FulfillmentDetail` | BenefitAllocationFulfillmentDetail | no |  |
| `FulfillmentTypes` | array<FulfillmentType> | no |  |
| `Id` | string | no |  |
| `Name` | string | no |  |
| `StartsAt` | string | no |  |
| `Status` | BenefitAllocationStatus | no |  |
| `StatusReason` | string | no |  |
| `UpdatedAt` | string | no |  |

**`BenefitApplication`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `Arn` | string | no |  |
| `AssociatedResources` | array<string> | no |  |
| `Attributes` | object | no |  |
| `BenefitApplicationDetails` | object | no |  |
| `BenefitId` | string | no |  |
| `Catalog` | string | no |  |
| `CreatedAt` | string | no |  |
| `Description` | string | no |  |
| `FileDetails` | array<FileDetail> | no |  |
| `FulfillmentTypes` | array<FulfillmentType> | no |  |
| `Id` | string | no |  |
| `Name` | string | no |  |
| `PartnerContacts` | array<AceContact> | no |  |
| `Programs` | array<string> | no |  |
| `Revision` | string | no |  |
| `Stage` | string | no |  |
| `Status` | BenefitApplicationStatus | no |  |
| `StatusReason` | string | no |  |
| `StatusReasonCodes` | array<string> | no |  |
| `UpdatedAt` | string | no |  |

**`FundingApplicationCosellAgentInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `approvedBy` | string | no | ApprovedBy is the person who approved it; in AUTO, the person the run acted for. |
| `mode` | CosellAgentMode | no |  |
| `referralId` | string | no | ReferralID is the co-sell referral the application was filed for. |
| `runId` | string | no | RunID is the agent run that proposed it ("chat" for one made in the co-sell chat). |
| `skillId` | string | no | SkillID is the agent skill that proposed it. |

**`FileDetail`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `BusinessUseCase` | string | no | Project Plan/Checklist", "Innovation Plan", "Marketing Plan", " Proof of Cost", "Assess Analysis Report", "Well Architected Review Report", "Success Criteria Report", "Customer Sign Off Template", "Partner Sign Off Template", "Customer Satisfaction Survey (CSAT)", "Migration Capability Review", "Other" |
| `CreatedAt` | string | no |  |
| `FileName` | string | no | ^[a-zA-Z0-9._-]+$ |
| `FileStatus` | string | no | PENDING, SUCCEDED, FAILED |
| `FileType` | string | no | Valid mime type:application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.openxmlformats-officedocument.presentationml.presentation, application/pdf, image/png, image/jpeg, image/svg+xml, text/csv |
| `FileURI` | string | no |  |
| `UpdatedAt` | string | no |  |

**`AceContact`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `BusinessTitle` | string | no |  |
| `Email` | string | no |  |
| `FirstName` | string | no |  |
| `LastName` | string | no |  |
| `Phone` | string | no |  |

### 400 — Bad request error

Content-Type: `application/json`

### 500 — Internal server error

Content-Type: `application/json`

## Example

_Generated from this operation's schema. Values are placeholders — substitute your own ids, and set `SUGER_TOKEN` to a bearer token from the [OAuth client-credentials exchange](https://doc.fours.com/settings/oauth-app/)._

### Request

```bash
curl -X GET 'https://api.suger.cloud/org/{orgId}/fundingApplication' \
  -H "Authorization: Bearer $SUGER_TOKEN"
```

### Response — 200

```json
{
  "data": [
    {
      "approvalInfo": {
        "approvalStatus": "Submitted",
        "decisionDate": "2026-01-31T12:00:00Z",
        "message": "string",
        "requestDate": "2026-01-31T12:00:00Z"
      },
      "creationTime": "2026-01-31T12:00:00Z",
      "errorMessages": [
        "string"
      ],
      "externalId": "01H0000000000000000000",
      "hubspotDealId": "01H0000000000000000000",
      "id": "01H0000000000000000000",
      "info": {
        "awsBenefitAllocation": {
          "ApplicableBenefitIds": [],
          "Arn": "string",
          "BenefitApplicationId": "01H0000000000000000000",
          "BenefitId": "01H0000000000000000000",
          "Catalog": "string",
          "CreatedAt": "string",
          "Description": "string",
          "ExpiresAt": "string",
          "FulfillmentDetail": {},
          "FulfillmentTypes": [],
          "Id": "01H0000000000000000000",
          "Name": "Acme Corp"
        },
        "awsBenefitAllocations": [
          {}
        ],
        "awsBenefitApplication": {
          "Arn": "string",
          "AssociatedResources": [],
          "Attributes": {},
          "BenefitId": "01H0000000000000000000",
          "Catalog": "string",
          "CreatedAt": "string",
          "Description": "string",
          "FileDetails": [],
          "FulfillmentTypes": [],
          "Id": "01H0000000000000000000",
          "Name": "Acme Corp"
        },
        "cosellAgent": {
          "approvedBy": "string",
          "mode": "REVIEW",
          "referralId": "01H0000000000000000000",
          "runId": "01H0000000000000000000",
          "skillId": "01H0000000000000000000"
        }
      },
      "lastUpdateTime": "2026-01-31T12:00:00Z",
      "organizationId": "01H0000000000000000000",
      "partner": "AWS",
      "salesforceFundingId": "01H0000000000000000000",
      "salesforceOpportunityId": "01H0000000000000000000"
    }
  ],
  "page_number": 1,
  "page_size": 1,
  "total_count": 1,
  "total_count_capped": true
}
```

### Error — 400

```json
"string"
```

---

API reference: https://doc.fours.com/api/
