---
updatedAt: 2025-10-02T22:24:53.000Z
agentTools:
  projectIndex: https://developer.bill.com/v2/llms.txt
---

# Read a vendor credit approver

Read a vendor credit approver object.

### Who is a vendor credit approver?
You can assign approvers to a vendor credit that requires one or more mandatory approvers. When you apply an approval policy to a vendor credit object, you can designate specific approvers (including the sequence of approvals) with `/v2/SetApprovers.json`.

**Note**: To replace an approver assigned to a vendor credit or to change the sequence of approvals, remove all approvers assigned to the vendor credit (with `/v2/ClearApprovers.json`) and then designate specific approvers (including the sequence of approvals) with `/v2/SetApprovers.json`.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "AP | Approvals",
    "version": "2.0",
    "description": "BILL is a cloud-based cash flow management system for an organization's Accounts Payable (AP) and Accounts Receivable (AR) automation.\n * **AP**: Automate workflows to pay vendors bills at scale for the goods and services they provide. Pay vendors with a wide range of payment methods. Generate vendor credits, bill credits, and payment disbursement reports.\n * **AR**: Automate workflows to get paid by customers at scale for the goods and services you provide. Generate and send invoices on a schedule, generate customer and invoice credits, and seamlessly charge authorized customers.\n * **Organization**: Manage your bank accounts (for sending and receiving payments), users (with user roles), and sync with your choice of accounting software.\n\nIntegrate with the BILL API to send and receive payments for your business. See [Support Center](https://help.bill.com/hc/en-us) for resources about using the BILL web app.",
    "contact": {
      "email": "developerprogram@hq.bill.com"
    }
  },
  "servers": [
    {
      "url": "https://api-stage.bill.com/api/v2",
      "description": "Sandbox base URL"
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "java",
      "javascript",
      "python",
      "ruby"
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "paths": {
    "/Crud/Read/VendorCreditApprover.json": {
      "post": {
        "summary": "Read a vendor credit approver",
        "operationId": "ap-approvals-readvendorcreditapprover",
        "description": "Read a vendor credit approver object.\n\n### Who is a vendor credit approver?\nYou can assign approvers to a vendor credit that requires one or more mandatory approvers. When you apply an approval policy to a vendor credit object, you can designate specific approvers (including the sequence of approvals) with `/v2/SetApprovers.json`.\n\n**Note**: To replace an approver assigned to a vendor credit or to change the sequence of approvals, remove all approvers assigned to the vendor credit (with `/v2/ClearApprovers.json`) and then designate specific approvers (including the sequence of approvals) with `/v2/SetApprovers.json`.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReadVendorCreditApproverResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "devKey",
                  "sessionId",
                  "data"
                ],
                "properties": {
                  "devKey": {
                    "type": "string",
                    "description": "Developer key generated with your BILL developer account"
                  },
                  "sessionId": {
                    "type": "string",
                    "description": "API session ID generated with [`/v2/Login.json`](ref:auth-login)"
                  },
                  "data": {
                    "$ref": "#/components/schemas/ReadVendorCreditApproverRequest"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Bill & vendor credit approvers"
        ]
      },
      "parameters": []
    }
  },
  "components": {
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "error_code": {
            "type": "string",
            "description": "Error code (only when `response_status` is `1`)"
          },
          "error_message": {
            "type": "string",
            "description": "Error message (only when `response_status` is `1`)"
          }
        }
      },
      "ReadVendorCreditApproverRequest": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "BILL-generated ID of the vendor credit approver. The value begins with `vca`."
          }
        }
      },
      "ReadVendorCreditApproverResponse": {
        "type": "object",
        "properties": {
          "response_status": {
            "type": "integer",
            "description": "Response status.\n* `0`: Success response\n* `1`: Error response. Only `error_code` and `error_message` is returned in `response_data`."
          },
          "response_message": {
            "type": "string",
            "description": "Response status.\n* `Success`: Success response\n* `Error`: Error response. Only `error_code` and `error_message` is returned in `response_data`."
          },
          "response_data": {
            "type": "object",
            "allOf": [
              {
                "$ref": "#/components/schemas/ErrorResponse"
              }
            ],
            "properties": {
              "entity": {
                "type": "string",
                "description": "Object type. Set as `VendorCreditApprover`."
              },
              "id": {
                "type": "string",
                "description": "BILL-generated ID of the vendor credit approver. The value begins with `vca`."
              },
              "usersId": {
                "type": "string",
                "description": "BILL-generated ID of the approver user. The value begins with `006`."
              },
              "vendorCreditId": {
                "type": "string",
                "description": "BILL-generated ID of the vendor credit. The value begins with `vcr`."
              },
              "lastReminderDate": {
                "type": "string",
                "description": "Timestamp of last approval reminder for the vendor credit"
              },
              "sortOrder": {
                "type": "integer",
                "description": "Order of the approver in the vendor credit approval process. The value starts at `0`."
              },
              "status": {
                "type": "string",
                "description": "Vendor credit approval status.\n* `0`: Waiting\n* `1`: Viewed\n* `2`: Rerouted\n* `3`: Denied\n* `4`: Approved\n* `5`: Upcoming\n* `6`: Stale"
              },
              "statusChangedDate": {
                "type": "string",
                "description": "Timestamp of last change in approval status"
              },
              "isActive": {
                "type": "string",
                "description": "Object visibility status. Inactive objects are hidden by default in the BILL web app.\n* `1`: Active\n* `2`: Inactive"
              }
            }
          }
        }
      }
    }
  }
}
```