---
updatedAt: 2026-06-29T20:33:19.000Z
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# Get funding account permissions

Get the funding account permissions available for the current organization and current organization user.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "BILL v3 API",
    "description": "BILL is a cloud-based financial operations platform for an organization's accounts payable (AP), accounts receivable (AR), and spend & expense (S&E) automation.\n\nThe BILL v3 API gives you access to the same infrastructure that powers the AP, AR, and S&E products. In addition, you can receive real-time event notifications with webhooks.\n\nThe BILL Developer Documentation is available at [developer.bill.com](https://developer.bill.com/docs/home).\n\n## Quickstart\nSign-up and generate a developer key for working with the BILL v3 API. With this key, you can build with the AP, AR, BILL network, and webhook workflows. See [Sandbox API sign up](https://developer.bill.com/docs/api-sandbox-sign-up) for more information.\n\n### Spend & Expense API\nAn API token is required for working with the Spend & Expense API. See [Authentication with Spend & Expense API token](https://developer.bill.com/docs/authentication-with-api-token) for more information.\n\n### BILL v3 API in Postman\nWith this collection, you have access to the BILL v3 API in Postman. When you save your sandbox API credentials as environment variables in Postman, you can simply refer to the variables when you are testing with the BILL v3 API. See [BILL v3 API in Postman](https://developer.bill.com/docs/bill-v3-api-in-postman) for more information.",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://gateway.stage.bill.com/connect",
      "description": "sandbox"
    }
  ],
  "paths": {
    "/v3/funding-accounts/permissions": {
      "get": {
        "tags": [
          "funding-accounts"
        ],
        "summary": "Get funding account permissions",
        "description": "Get the funding account permissions available for the current organization and current organization user.",
        "operationId": "getFundingAccountPermission",
        "parameters": [
          {
            "name": "sessionId",
            "in": "header",
            "schema": {
              "type": "string",
              "description": "API session ID generated with `/v3/login`",
              "nullable": true,
              "example": "{{session_id}}"
            }
          },
          {
            "name": "devKey",
            "in": "header",
            "schema": {
              "type": "string",
              "description": "Developer key generated with your BILL developer account",
              "nullable": true,
              "example": "{{developer_key}}"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get funding account permissions response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FundingAccountPermissionResponseDto"
                }
              }
            }
          },
          "4XX": {
            "description": "List of errors.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BdcError"
                  }
                }
              }
            }
          },
          "5XX": {
            "description": "List of errors.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BdcError"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "BdcError": {
        "required": [
          "category",
          "code",
          "severity",
          "timestamp"
        ],
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "code": {
            "type": "string"
          },
          "severity": {
            "$ref": "#/components/schemas/Severity"
          },
          "category": {
            "$ref": "#/components/schemas/Category"
          },
          "message": {
            "type": "string"
          },
          "params": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Param"
            }
          },
          "detail": {
            "type": "string"
          },
          "help": {
            "type": "string"
          }
        }
      },
      "CardPermission": {
        "type": "object",
        "properties": {
          "payByCard": {
            "type": "boolean",
            "description": "This field is set as `true` if you can pay by card"
          },
          "fundingEnabled": {
            "type": "boolean",
            "description": "This field is set as `true` if you can add a card account as a payment method"
          },
          "amexAllowed": {
            "type": "boolean",
            "description": "This field is set as `true` if you can pay with an AMEX credit card"
          }
        },
        "description": "Funding Account Card Permission response."
      },
      "Category": {
        "type": "string",
        "enum": [
          "REQUEST",
          "APPLICATION",
          "SERVER",
          "DOWNSTREAM"
        ]
      },
      "FundingAccountPermissionResponseDto": {
        "type": "object",
        "properties": {
          "organization": {
            "allOf": [
              {
                "$ref": "#/components/schemas/OrganizationPermission"
              },
              {
                "description": "Funding account permissions available for the current organization"
              }
            ]
          },
          "user": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserPermission"
              },
              {
                "description": "Funding account permissions available for the current user"
              }
            ]
          }
        },
        "description": "Funding Account Permission response DTO."
      },
      "OrganizationPermission": {
        "type": "object",
        "properties": {
          "card": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CardPermission"
              },
              {
                "description": "Card funding account permissions"
              }
            ]
          },
          "wallet": {
            "allOf": [
              {
                "$ref": "#/components/schemas/WalletPermission"
              },
              {
                "description": "Wallet (BILL balance) funding account permissions"
              }
            ]
          }
        },
        "description": "Organization level permission response DTO."
      },
      "Param": {
        "required": [
          "name",
          "value"
        ],
        "type": "object",
        "properties": {
          "additional": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "name": {
            "minLength": 1,
            "type": "string"
          },
          "value": {
            "minLength": 1,
            "type": "string"
          }
        }
      },
      "Severity": {
        "type": "string",
        "enum": [
          "ERROR",
          "WARNING",
          "INFORMATION"
        ]
      },
      "UserPermission": {
        "type": "object",
        "properties": {
          "payOnline": {
            "type": "boolean",
            "description": "This field is set as `true` if you can make online payments"
          }
        },
        "description": "User level permission response DTO."
      },
      "WalletPermission": {
        "type": "object",
        "properties": {
          "fundingEnabled": {
            "type": "boolean",
            "description": "This field is set as `true` if you have access to Wallet (BILL balance) as a payment method"
          }
        },
        "description": "Funding account wallet permission response."
      }
    }
  }
}
```